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