CKTIS / JavaScript
Node — ein DOM-Knoten
Node ist die gemeinsame Schnittstelle für DOM-Knoten, darunter Elemente und Text. Damit lassen sich Beziehungen im Baum prüfen, Knotentypen auslesen und die Kinder eines Knotens ändern.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 steht für einen DOM-Knoten, nicht nur für ein Element. nodeType unterscheidet unter anderem Node.ELEMENT_NODE (1) und Node.TEXT_NODE (3). nodeValue stellt Text- oder Kommentardaten sowie Attributwerte bereit, gibt für ein Element aber null zurück; eine Zuweisung an einem Element bewirkt nichts.
childNodes ist eine lebende NodeList aller direkten Kinder, einschließlich Leerraumtext und Kommentaren. Änderungen am Baum aktualisieren die Sammlung. firstChild gibt das erste Kind beliebigen Typs oder null zurück. parentNode gibt den Elternknoten oder null zurück; parentElement gibt ihn nur zurück, wenn er ein Element ist, andernfalls null.
contains(other) prüft, ob other derselbe Knoten oder ein Nachfahre ist; für null wird false zurückgegeben. Die Prüfung überschreitet keine Shadow-Tree-Grenze. isConnected gibt an, ob der Knoten mit einem Dokument verbunden ist, auch über einen Shadow Tree, und nicht, ob er auf dem Bildschirm sichtbar ist.
insertBefore(newNode, referenceNode) gibt newNode zurück. Ist newNode ein DocumentFragment, fügt die Methode dessen Kinder statt des Fragments selbst ein und gibt dasselbe, nun leere Fragment zurück. Andernfalls fügt sie newNode selbst ein. Der Referenzknoten muss ein direktes Kind sein; ein explizites null bedeutet das Ende der Liste. Ein vorhandener Knoten wird verschoben, nicht kopiert. Ein ungültiger Referenz-Elternknoten verursacht NotFoundError, eine unzulässige Hierarchie HierarchyRequestError. normalize() entfernt leere gewöhnliche Text-Knoten im Teilbaum und führt benachbarte gewöhnliche Text-Knoten zusammen. Dabei bleibt jeweils der erste nicht leere Knoten der zusammengeführten Folge erhalten. CDATASection-Knoten werden weder entfernt noch zusammengeführt, auch wenn sie leer sind; sie trennen Folgen gewöhnlicher Text-Knoten voneinander. Leerraumzeichen in nicht leerem Text werden nicht entfernt.
Führe das Beispiel in einem Browser mit DOM aus. Die Verwendung von Node 24 in einem Repository belegt für sich allein keine Unterstützung dieser Browser-API.
In diesem Eintrag behandelte Referenzbezeichner: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.
Beispiele
(() => {
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);
})();Ergebnis
2 true true true true true true false false 1 AB true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.