Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.firstChild

Node.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.

Zdroje