CKTIS / JavaScript
Node.firstChild — prvi podređeni čvor
Node.firstChild je svojstvo samo za čitanje koje vraća prvi izravni podređeni čvor ili null. Uključuje i tekst i komentare, pa vraćeni čvor ne mora biti element.
Verzija: 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.firstChildNode.firstChild čita prvi izravni podređeni čvor prema redoslijedu stabla, a ne prvi element na bilo kojoj dubini. Vraća objekt Node ili null ako čvor nema djece. To je svojstvo samo za čitanje, a ne metoda: upotrijebite node.firstChild, bez zagrada za poziv.
Dijete može biti element, čvor Text ili čvor Comment. Računa se i tekst koji sadrži samo bjeline. Ako vam treba prvo dijete koje je element, upotrijebite firstElementChild na objektu Element, Document ili DocumentFragment; to svojstvo preskače tekst i komentare.
Provjerite je li rezultat null prije pristupa njegovim svojstvima. Čitanjem se ne stvara kopija: vraćeni čvor možete mijenjati. Nakon dodavanja ili uklanjanja djece, novo čitanje svojstva firstChild odražava trenutačno stablo; prethodno spremljena referenca ne prebacuje se na novo prvo dijete.
Primjer stvara odvojeni element, dodaje tekst s bjelinama i element, a zatim uklanja djecu. Potrebno je DOM okruženje preglednika. Ovo je API standarda DOM, a ne značajka određene edicije ECMAScripta; verzija Node.js u repozitoriju ne dokazuje podršku za API-je preglednika.
Primjeri
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);Rezultat
true true true true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.