CKTIS / JavaScript
Node.firstChild — pierwszy węzeł potomny
Node.firstChild to właściwość tylko do odczytu, która zwraca pierwszy bezpośredni węzeł potomny lub null. Uwzględnia także tekst i komentarze, więc nie musi wskazywać elementu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
node.firstChildNode.firstChild odczytuje pierwszy bezpośredni węzeł potomny w kolejności drzewa, a nie pierwszy dowolnie głęboki element. Zwraca obiekt Node albo null, jeśli węzeł nie ma dzieci. Jest to właściwość tylko do odczytu, nie metoda: używaj node.firstChild, bez nawiasów wywołania.
Dzieckiem może być element, węzeł Text lub Comment. Tekst zawierający wyłącznie białe znaki również się liczy. Jeśli potrzebujesz pierwszego dziecka będącego elementem, użyj firstElementChild na obiekcie Element, Document lub DocumentFragment; ta właściwość pomija tekst i komentarze.
Przed użyciem właściwości wyniku sprawdź, czy nie jest on null. Odczyt nie tworzy kopii: zwrócony węzeł można modyfikować. Po dodaniu lub usunięciu dzieci kolejny odczyt firstChild odzwierciedla aktualne drzewo; wcześniej zapisana referencja nie przełącza się na nowe pierwsze dziecko.
Przykład tworzy odłączony element, dodaje tekst z białymi znakami i element, a następnie usuwa dzieci. Wymaga środowiska DOM przeglądarki. To API standardu DOM, a nie funkcja określonej edycji ECMAScript; wersja Node.js w repozytorium nie dowodzi obsługi API przeglądarki.
Przykłady
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);Wynik
true true true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.