CKTIS / JavaScript
Node.firstChild — první podřízený uzel
Node.firstChild je vlastnost pouze pro čtení, která vrací první přímý podřízený uzel nebo null. Zahrnuje také text a komentáře, takže vrácený uzel nemusí být element.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.firstChildNode.firstChild čte první přímý podřízený uzel v pořadí stromu, nikoli první element v libovolné hloubce. Vrací objekt Node, nebo null, pokud uzel nemá žádné potomky. Jde o vlastnost pouze pro čtení, nikoli o metodu: použijte node.firstChild bez závorek pro volání.
Potomkem může být element, uzel Text nebo uzel Comment. Počítá se i text obsahující pouze bílé znaky. Pokud potřebujete první dítě, které je elementem, použijte firstElementChild na objektu Element, Document nebo DocumentFragment; tato vlastnost text a komentáře vynechává.
Než přistoupíte k vlastnostem výsledku, ověřte, že není null. Čtením se nevytváří kopie: vrácený uzel můžete upravit. Po přidání nebo odebrání potomků další čtení firstChild odráží aktuální strom; dříve uložený odkaz se nepřepne na nové první dítě.
Příklad vytvoří odpojený element, přidá text s bílými znaky a element a poté potomky odebere. Vyžaduje DOM prostředí prohlížeče. Jde o API standardu DOM, nikoli o funkci určité edice ECMAScriptu; verze Node.js v repozitáři nedokládá podporu API prohlížeče.
Příklady
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);Výsledek
true true true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.