Dom CORE : Objet NamedNodeMap->setNamedItem

La méthode javascript setNamedItem

Définition

La méthode javascript NamedNodeMap.setNamedItem(ObjNoeux) permet de d'ajouter un noeud dans la NamedNodeMap en fonction de son Nom.
Exemple de code :
<input id="toto" name="toto" type="button" value="default"/>

var Element = document.getElementById("toto");
var NamedNodeMap = Element.attributes;
alert(NamedNodeMap.getNamedItem("type").value);
//Renvoie button

Paramètres de setNamedItem

Paramètre

La méthode javascript NamedNodeMap.setNamedItem(ObjNoeux) accepte comme paramètre :
- ObjNoeux, valeur de type Node, qui correspond à l'objet Node à insérer.

Valeur retournée de setNamedItem

Valeur retournée

La méthode javascript NamedNodeMap.setNamedItem() renvoie :
- objet noeux son type est différent suivant les cas, il correspond au noeux remplacé,
- null, si pas de noeux remplacé.

Exceptions de setNamedItem

Exception

La méthode javascript NamedNodeMap.getNamedItem() renvoie comme exception :
- WRONG_DOCUMENT_ERR, si le paramètre ObjNoeux a été créé à partir d'un document différent de celui qui a créé cette carte.
- NO_MODIFICATION_ALLOWED_ERR , si NamedNodeMap est en lecture seule.
- INUSE_ATTRIBUTE_ERR : Soulevée si ObjNoeux est un objet Attr qui est déjà l'attribut d'un autre objet Element. L'utilisateur du DOM doit cloner.
- HIERARCHY_REQUEST_ERR : Soulevée pour une tentative d'ajout d'un nœud qui est déjà utilisé