Dom CORE : Objet NamedNodeMap.setNamedItem

La méthode javascript setNamedItem

Définition

La méthode javascript NamedNodeMap.setNamedItem(ObjNoeud) 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(ObjNoeud) accepte comme paramètre :
- ObjNoeud, 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 noeud son type est différent suivant les cas, il correspond au noeud 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 ObjNoeud 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 ObjNoeud 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é