CKTIS / JavaScript
Node — un nodo DOM
Node es la interfaz común de los nodos DOM, incluidos los elementos y el texto. Permite consultar las relaciones del árbol, leer el tipo de un nodo y modificar sus hijos.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
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 representa un nodo DOM, no solo un elemento. nodeType distingue, entre otros, Node.ELEMENT_NODE (1) y Node.TEXT_NODE (3). nodeValue expone datos de texto o comentarios y valores de atributos, pero devuelve null para un elemento; asignarle un valor en un elemento no hace nada.
childNodes es una NodeList viva de todos los hijos directos, incluidos los nodos de texto con espacios en blanco y los comentarios. Los cambios en el árbol actualizan la colección. firstChild devuelve el primer hijo, sea del tipo que sea, o null. parentNode devuelve el padre o null; parentElement solo devuelve ese padre si es un elemento; de lo contrario, devuelve null.
contains(other) comprueba si other es el mismo nodo o un descendiente; devuelve false para null. No atraviesa el límite de un árbol shadow. isConnected indica la conexión con un documento, también a través de un árbol shadow, no la visibilidad en pantalla.
insertBefore(newNode, referenceNode) devuelve newNode. Si newNode es un DocumentFragment, el método inserta los hijos del fragmento en lugar del fragmento mismo y devuelve ese mismo fragmento, que queda vacío. En los demás casos, inserta el propio newNode. La referencia debe ser un hijo directo; null explícito indica el final de la lista. Un nodo existente se mueve, no se copia. Un padre de referencia no válido provoca NotFoundError, y una jerarquía no permitida provoca HierarchyRequestError. normalize() elimina los nodos Text ordinarios vacíos del subárbol y combina los nodos Text ordinarios adyacentes, conservando el primer nodo no vacío de cada secuencia combinada. No elimina ni combina los nodos CDATASection, aunque estén vacíos; estos separan las secuencias de nodos Text ordinarios. No elimina los espacios en blanco del texto no vacío.
Ejecuta el ejemplo en un navegador con DOM. Usar Node 24 en un repositorio no demuestra por sí solo que esta API del navegador esté disponible.
Identificadores de referencia incluidos en esta entrada: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.
Ejemplos
(() => {
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);
})();Resultado
2 true true true true true true false false 1 AB true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.