CKTIS / JavaScript
Node — vozlišče DOM
Node je skupni vmesnik za vozlišča DOM, vključno z elementi in besedilom. Omogoča preverjanje odnosov v drevesu, branje vrste vozlišča in spreminjanje njegovih otrok.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 predstavlja vozlišče DOM, ne le elementa. nodeType med drugim razlikuje med Node.ELEMENT_NODE (1) in Node.TEXT_NODE (3). nodeValue razkriva besedilne podatke ali podatke komentarja ter vrednosti atributov, za element pa vrne null; prirejanje vrednosti elementu nima učinka.
childNodes je živa zbirka NodeList vseh neposrednih otrok, vključno z besedilnimi vozlišči, ki vsebujejo presledke, in komentarji. Spremembe drevesa posodobijo zbirko. firstChild vrne prvega otroka poljubne vrste ali null. parentNode vrne nadrejeno vozlišče ali null; parentElement ga vrne le, če je element, sicer vrne null.
contains(other) preveri, ali je other isto vozlišče ali njegov potomec; za null vrne false. Ne prečka meje senčnega drevesa. isConnected označuje povezavo z dokumentom, tudi prek senčnega drevesa, ne pa vidnosti na zaslonu.
insertBefore(newNode, referenceNode) vrne newNode. Če je newNode objekt DocumentFragment, metoda vstavi njegove otroke namesto samega fragmenta in vrne isti, zdaj prazen fragment. Sicer vstavi sam newNode. Referenca mora biti neposreden otrok; izrecni null pomeni konec seznama. Obstoječe vozlišče se premakne, ne kopira. Neveljaven nadrejeni element reference povzroči NotFoundError, nedovoljena hierarhija pa HierarchyRequestError. normalize() odstrani prazna navadna vozlišča Text v poddrevesu in združi sosednja navadna vozlišča Text, pri čemer v vsakem združenem zaporedju ohrani prvo neprazno vozlišče. Vozlišč CDATASection ne odstranjuje in ne združuje, tudi če so prazna; ta vozlišča ločujejo zaporedja navadnih vozlišč Text. Belih znakov v nepraznem besedilu ne odstrani.
Primer zaženite v brskalniku z DOM. Uporaba Node 24 v repozitoriju sama po sebi ne potrjuje podpore za ta API brskalnika.
Referenčni identifikatorji, zajeti v tem geslu: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.
Primeri
(() => {
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);
})();Rezultat
2 true true true true true true false false 1 AB true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.