CKTIS / JavaScript
Node — un nœud DOM
Node est l’interface commune aux nœuds DOM, notamment aux éléments et au texte. Elle permet d’examiner les relations dans l’arbre, de lire le type d’un nœud et de modifier ses enfants.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.contains(other)
node.firstChild
node.parentElement
node.insertBefore(newNode, referenceNode)
node.normalize()
node.parentNode
node.isConnected
node.nodeType
node.nodeValue
node.childNodes
Node.TEXT_NODE
Node.ELEMENT_NODENode représente un nœud DOM, pas seulement un élément. nodeType distingue notamment Node.ELEMENT_NODE (1) et Node.TEXT_NODE (3). nodeValue expose les données de texte ou de commentaire, ainsi que les valeurs d’attribut, mais renvoie null pour un élément ; lui attribuer une valeur sur un élément ne fait rien.
childNodes est une NodeList vivante de tous les enfants directs, y compris les nœuds de texte contenant des espaces et les commentaires. Les changements de l’arbre mettent à jour cette collection. firstChild renvoie le premier enfant, quel que soit son type, ou null. parentNode renvoie le parent ou null ; parentElement ne renvoie ce parent que s’il s’agit d’un élément, sinon null.
contains(other) vérifie si other est le même nœud ou un descendant ; la méthode renvoie false pour null. Elle ne franchit pas une limite d’arbre fantôme. isConnected indique une connexion à un document, y compris via un arbre fantôme, et non une visibilité à l’écran.
insertBefore(newNode, referenceNode) renvoie newNode. Si newNode est un DocumentFragment, la méthode insère les enfants du fragment, et non le fragment lui-même, puis renvoie ce même fragment, désormais vide. Sinon, elle insère newNode lui-même. La référence doit être un enfant direct ; null explicite signifie la fin de la liste. Un nœud existant est déplacé, et non copié. Une référence dont le parent est invalide provoque NotFoundError, et une hiérarchie interdite provoque HierarchyRequestError. normalize() supprime les nœuds Text ordinaires vides du sous-arbre et fusionne les nœuds Text ordinaires adjacents, en conservant le premier nœud non vide de chaque suite fusionnée. Elle ne supprime ni ne fusionne les nœuds CDATASection, même vides ; ceux-ci séparent les suites de nœuds Text ordinaires. Elle ne retire pas les caractères d’espacement d’un texte non vide.
Exécutez l’exemple dans un navigateur avec un DOM. L’utilisation de Node 24 dans un dépôt ne prouve pas à elle seule la prise en charge de cette API de navigateur.
Identifiants de référence couverts par cette entrée : Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.
Exemples
(() => {
const root = document.createElement('div');
const text = document.createTextNode('A');
root.insertBefore(text, null);
root.insertBefore(document.createTextNode('B'), null);
const children = root.childNodes;
console.log(children.length);
console.log(root.nodeType === Node.ELEMENT_NODE);
console.log(text.nodeType === Node.TEXT_NODE);
console.log(text.parentNode === root, text.parentElement === root);
console.log(root.contains(text), root.contains(root), root.contains(null));
console.log(root.isConnected);
root.normalize();
console.log(children.length, root.firstChild.nodeValue);
console.log(root.nodeValue === null);
})();Résultat
2 true true true true true true false false 1 AB true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.