Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Node.firstChild — prvo podrejeno vozlišče

Node.firstChild je lastnost samo za branje, ki vrne prvo neposredno podrejeno vozlišče ali null. Upošteva tudi besedilo in komentarje, zato vrnjeno vozlišče ni nujno element.

Različica: 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.firstChild

Node.firstChild prebere prvo neposredno podrejeno vozlišče v vrstnem redu drevesa, ne pa prvega elementa na poljubni globini. Vrne objekt Node ali null, če vozlišče nima otrok. To je lastnost samo za branje, ne metoda: uporabite node.firstChild brez oklepajev za klic.

Otrok je lahko element, vozlišče Text ali vozlišče Comment. Upošteva se tudi besedilo, ki vsebuje samo presledke. Če potrebujete prvega otroka, ki je element, uporabite firstElementChild na objektu Element, Document ali DocumentFragment; ta lastnost preskoči besedilo in komentarje.

Pred dostopom do lastnosti rezultata preverite, ali je null. Branje ne ustvari kopije: vrnjeno vozlišče lahko spreminjate. Ko dodate ali odstranite otroke, naslednje branje firstChild odraža trenutno drevo; prej shranjeni sklic se ne preusmeri na novega prvega otroka.

Primer ustvari odklopljen element, doda besedilo s presledki in element ter nato odstrani otroke. Potrebuje okolje DOM v brskalniku. To je API standarda DOM, ne funkcija določene izdaje ECMAScripta; različica Node.js v repozitoriju ne dokazuje podpore za API-je brskalnika.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri