CKTIS / JavaScript
Node — un nodo DOM
Node è l’interfaccia comune dei nodi DOM, inclusi gli elementi e il testo. Permette di esaminare le relazioni nell’albero, leggere il tipo di un nodo e modificare i suoi figli.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
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 rappresenta un nodo DOM, non solo un elemento. nodeType distingue, tra gli altri, Node.ELEMENT_NODE (1) e Node.TEXT_NODE (3). nodeValue espone i dati di testo o commento e i valori degli attributi, ma restituisce null per un elemento; assegnargli un valore su un elemento non produce effetti.
childNodes è una NodeList viva di tutti i figli diretti, inclusi i nodi di testo contenenti spazi e i commenti. Le modifiche all’albero aggiornano la raccolta. firstChild restituisce il primo figlio, di qualsiasi tipo, oppure null. parentNode restituisce il genitore o null; parentElement restituisce quel genitore solo se è un elemento, altrimenti null.
contains(other) verifica se other è lo stesso nodo o un discendente; restituisce false per null. Non oltrepassa il confine di uno shadow tree. isConnected indica la connessione a un documento, anche attraverso uno shadow tree, non la visibilità sullo schermo.
insertBefore(newNode, referenceNode) restituisce newNode. Se newNode è un DocumentFragment, il metodo inserisce i figli del frammento anziché il frammento stesso e restituisce lo stesso frammento, ormai vuoto. Altrimenti inserisce newNode stesso. Il riferimento deve essere un figlio diretto; null esplicito indica la fine dell’elenco. Un nodo esistente viene spostato, non copiato. Un genitore del riferimento non valido causa NotFoundError, mentre una gerarchia non consentita causa HierarchyRequestError. normalize() rimuove i nodi Text ordinari vuoti nel sottoalbero e unisce i nodi Text ordinari adiacenti, mantenendo il primo nodo non vuoto di ogni sequenza unita. Non rimuove né unisce i nodi CDATASection, neanche se vuoti; questi separano le sequenze di nodi Text ordinari. Non rimuove i caratteri di spaziatura dal testo non vuoto.
Esegui l’esempio in un browser con DOM. L’uso di Node 24 in un repository non dimostra da solo il supporto di questa API del browser.
Identificatori di riferimento trattati in questa voce: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.
Esempi
(() => {
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);
})();Risultato
2 true true true true true true false false 1 AB true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.