CKTIS / JavaScript
DOM-Knoten: Typ, Wert und Kindknoten
Unterscheide Textknoten von Elementen, lies den Wert eines einzelnen Knotens und beachte beim Durchlaufen direkter Kinder, dass sich die Liste laufend aktualisiert.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
node.nodeType
node.nodeValue
node.nodeValue = text
node.childNodes
node.nodeType === Node.TEXT_NODE
node.nodeType === Node.ELEMENT_NODEDie schreibgeschützte Eigenschaft node.nodeType liefert eine Ganzzahl für den Knotentyp. Vergleiche sie mit === mit den Konstanten der Schnittstelle Node: Node.TEXT_NODE (3) bezeichnet einen Textknoten, Node.ELEMENT_NODE (1) ein Element. Ein Element und der darin enthaltene Text sind separate Knoten. Diese DOM-APIs gehören zur Webplattform, nicht zu ECMAScript 2024. Eine JavaScript-Laufzeitumgebung muss das DOM nicht bereitstellen.
node.nodeValue bezieht sich auf den Knoten selbst. Bei einem Textknoten liest du damit den Text; durch Zuweisen einer Zeichenfolge ersetzt du ihn, ohne dass die Zeichenfolge als HTML interpretiert wird. Auch ein Kommentar hat eine Zeichenfolge als Wert. Bei einem Element liefert die Eigenschaft null, und eine Zuweisung bleibt wirkungslos, selbst wenn das Element Text enthält. Den zusammengefassten Text der Nachfahren eines Elements liest du mit element.textContent; Kommentare und Verarbeitungsanweisungen bleiben dabei außen vor.
Die schreibgeschützte Eigenschaft node.childNodes liefert eine dynamische NodeList mit den direkten Kindknoten, nicht mit allen Nachfahren. Die Liste beginnt bei Index null und ist kein Array. Sie enthält Elemente, Textknoten und Kommentare. Einrückungen und Zeilenumbrüche in HTML können zu Textknoten werden, die nur Leerraum enthalten. Darum muss childNodes[0] kein Element sein. Für direkte Kindknoten, die Elemente sind, verwende element.children.
Auch eine gespeicherte Referenz auf die Liste zeigt an, wenn Kinder hinzugefügt oder entfernt werden. Beim Entfernen während eines Vorwärtsdurchlaufs können sich die Indizes verschieben, sodass du den nächsten Knoten überspringst. Wenn sich die Einträge beim Durchlaufen nicht ändern sollen, erstelle vorher mit Array.from(node.childNodes) ein Array. Es enthält Referenzen auf dieselben Knoten, keine Kopien.
Beispiele
{
const { document, Node } = globalThis.document && globalThis.Node
? globalThis
: createExampleDOM();
const parent = document.createElement("div");
const children = parent.childNodes;
console.log(children.length);
const text = document.createTextNode(" ");
const span = document.createElement("span");
span.appendChild(document.createTextNode("inside"));
parent.appendChild(text);
parent.appendChild(span);
console.log(children.length);
for (const child of children) {
const type = child.nodeType;
const kind = type === Node.TEXT_NODE ? "text" :
type === Node.ELEMENT_NODE ? "element" : "other";
console.log(JSON.stringify([kind, type, child.nodeValue]));
}
span.nodeValue = "ignored";
console.log(span.textContent);
text.nodeValue = "outside";
console.log(text.nodeValue);
// Plain Node.js has no DOM. This local model implements only the
// element, text, and live-list operations used by this example.
function createExampleDOM() {
class ExampleNode {
static TEXT_NODE = 3;
static ELEMENT_NODE = 1;
#type;
#value;
#children = [];
#list;
constructor(type, value = null) {
this.#type = type;
this.#value = value;
const children = this.#children;
this.#list = {
get length() { return children.length; },
[Symbol.iterator]() { return children[Symbol.iterator](); }
};
}
get nodeType() { return this.#type; }
get childNodes() { return this.#list; }
get nodeValue() { return this.#value; }
set nodeValue(value) {
if (this.#type === ExampleNode.TEXT_NODE) {
this.#value = value === null ? "" : String(value);
}
}
get textContent() {
if (this.#type === ExampleNode.TEXT_NODE) return this.#value;
return this.#children.map(child => child.textContent).join("");
}
appendChild(child) {
this.#children.push(child);
return child;
}
}
return {
Node: ExampleNode,
document: {
createElement: () => new ExampleNode(ExampleNode.ELEMENT_NODE),
createTextNode: value => new ExampleNode(ExampleNode.TEXT_NODE, String(value))
}
};
}
}Ergebnis
0 2 ["text",3," "] ["element",1,null] inside outside
Führe den Code in der Browserkonsole einer HTML-Seite aus. Die gespeicherte Liste wächst von `0` auf `2`, obwohl der Elternknoten nicht in die Seite eingefügt ist. Die JSON-Zeile für den Textknoten zeigt ein Leerzeichen in Anführungszeichen.
Zugehörige Lektionen
- JavaScript · Lektion 16 · Fortgeschritten · Version: 4