CKTIS / JavaScript
Node.firstChild — der erste untergeordnete Knoten
Node.firstChild ist eine schreibgeschützte Eigenschaft, die den ersten direkten untergeordneten Knoten oder null zurückgibt. Sie berücksichtigt auch Text und Kommentare, daher muss der zurückgegebene Knoten kein Element sein.
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.firstChildNode.firstChild liest den ersten direkten untergeordneten Knoten in der Baumreihenfolge aus, nicht das erste Element in beliebiger Tiefe. Die Eigenschaft gibt ein Node-Objekt oder null zurück, wenn der Knoten keine Kinder hat. Sie ist eine schreibgeschützte Eigenschaft und keine Methode: Verwenden Sie node.firstChild ohne Aufrufklammern.
Ein Kind kann ein Element, ein Text- oder ein Comment-Knoten sein. Auch Text, der ausschließlich aus Leerraum besteht, zählt. Wenn Sie das erste Kind benötigen, das ein Element ist, verwenden Sie firstElementChild auf einem Element, Document oder DocumentFragment; diese Eigenschaft überspringt Text und Kommentare.
Prüfen Sie auf null, bevor Sie auf Eigenschaften des Ergebnisses zugreifen. Beim Lesen wird keine Kopie erstellt: Sie können den zurückgegebenen Knoten ändern. Nachdem Kinder hinzugefügt oder entfernt wurden, spiegelt ein erneutes Lesen von firstChild den aktuellen Baum wider; eine zuvor gespeicherte Referenz wechselt nicht zum neuen ersten Kind.
Das Beispiel erstellt ein nicht angehängtes Element, fügt Leerraumtext und ein Element hinzu und entfernt anschließend die Kinder. Es erfordert eine DOM-Umgebung im Browser. Dies ist eine API des DOM-Standards und keine Funktion einer bestimmten ECMAScript-Ausgabe; die Node.js-Version in einem Repository belegt keine Unterstützung für Browser-APIs.
Beispiele
const parent = document.createElement('div');
const text = document.createTextNode('\n ');
const element = document.createElement('span');
parent.append(text, element);
console.log(parent.firstChild === text);
console.log(parent.firstChild.nodeType === Node.TEXT_NODE);
console.log(parent.firstElementChild === element);
parent.removeChild(text);
console.log(parent.firstChild === element);
parent.removeChild(element);
console.log(parent.firstChild === null);Ergebnis
true true true true 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.