Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Node.firstChild — prvý podradený uzol

Node.firstChild je vlastnosť iba na čítanie, ktorá vracia prvý priamy podradený uzol alebo null. Zahŕňa aj text a komentáre, takže vrátený uzol nemusí byť element.

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

Node.firstChild číta prvý priamy podradený uzol v poradí stromu, nie prvý element v ľubovoľnej hĺbke. Vracia objekt Node alebo null, ak uzol nemá žiadne deti. Je to vlastnosť iba na čítanie, nie metóda: použite node.firstChild bez zátvoriek volania.

Dieťaťom môže byť element, uzol Text alebo uzol Comment. Počíta sa aj text obsahujúci iba biele znaky. Ak potrebujete prvé dieťa, ktoré je elementom, použite firstElementChild na objekte Element, Document alebo DocumentFragment; táto vlastnosť vynecháva text a komentáre.

Pred prístupom k vlastnostiam výsledku skontrolujte, či nie je null. Čítaním sa nevytvára kópia: vrátený uzol môžete upraviť. Po pridaní alebo odstránení detí ďalšie čítanie firstChild odráža aktuálny strom; predtým uložený odkaz sa neprepne na nové prvé dieťa.

Príklad vytvorí odpojený element, pridá text s bielymi znakmi a element a potom deti odstráni. Vyžaduje DOM prostredie prehliadača. Ide o API štandardu DOM, nie o funkciu konkrétnej edície ECMAScriptu; verzia Node.js v repozitári nedokazuje podporu API prehliadača.

Prí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ýsledok

true
true
true
true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje