Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Node — węzeł DOM

Node to wspólny interfejs węzłów DOM, między innymi elementów i tekstu. Pozwala sprawdzać relacje w drzewie, odczytywać typ węzła i modyfikować jego dzieci.

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.contains(other)
node.firstChild
node.parentElement
node.insertBefore(newNode, referenceNode)
node.normalize()
node.parentNode
node.isConnected
node.nodeType
node.nodeValue
node.childNodes
Node.TEXT_NODE
Node.ELEMENT_NODE

Node reprezentuje węzeł DOM, nie tylko element. nodeType rozróżnia między innymi Node.ELEMENT_NODE (1) i Node.TEXT_NODE (3). nodeValue udostępnia dane tekstu lub komentarza, wartość atrybutu, a dla elementu zwraca null; przypisanie mu wartości na elemencie niczego nie zmienia.

childNodes to żywa kolekcja NodeList wszystkich bezpośrednich dzieci, również tekstu zawierającego białe znaki i komentarzy. Zmiany drzewa aktualizują kolekcję. firstChild zwraca pierwsze dziecko dowolnego typu albo null. parentNode zwraca rodzica lub null; parentElement zwraca go tylko wtedy, gdy jest elementem, w przeciwnym razie null.

contains(other) sprawdza, czy other jest tym samym węzłem lub jego potomkiem; dla null zwraca false. Nie przechodzi przez granicę drzewa cienia. isConnected wskazuje połączenie z dokumentem, także przez drzewo cienia, a nie widoczność na ekranie.

insertBefore(newNode, referenceNode) zwraca newNode. Jeśli newNode jest obiektem DocumentFragment, metoda wstawia jego dzieci zamiast samego fragmentu i zwraca ten sam, już pusty fragment. W pozostałych przypadkach wstawia sam newNode. Węzeł odniesienia musi być bezpośrednim dzieckiem; jawne null oznacza koniec listy. Istniejący węzeł zostaje przeniesiony, nie skopiowany. Nieprawidłowy rodzic odniesienia powoduje NotFoundError, a niedozwolona hierarchia — HierarchyRequestError. normalize() usuwa puste zwykłe węzły Text w poddrzewie i scala sąsiadujące zwykłe węzły Text, zachowując pierwszy niepusty węzeł w każdej scalanej grupie. Nie usuwa ani nie scala węzłów CDATASection, nawet pustych; oddzielają one od siebie ciągi zwykłych węzłów Text. Metoda nie usuwa białych znaków z niepustego tekstu.

Przykład uruchom w przeglądarce z DOM. Samo użycie Node 24 w repozytorium nie stanowi potwierdzenia obsługi tego API przeglądarkowego.

Identyfikatory objęte tym wpisem: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Przykłady

(() => {
  const root = document.createElement('div');
  const text = document.createTextNode('A');
  root.insertBefore(text, null);
  root.insertBefore(document.createTextNode('B'), null);
  const children = root.childNodes;

  console.log(children.length);
  console.log(root.nodeType === Node.ELEMENT_NODE);
  console.log(text.nodeType === Node.TEXT_NODE);
  console.log(text.parentNode === root, text.parentElement === root);
  console.log(root.contains(text), root.contains(root), root.contains(null));
  console.log(root.isConnected);

  root.normalize();
  console.log(children.length, root.firstChild.nodeValue);
  console.log(root.nodeValue === null);
})();

Wynik

2
true
true
true true
true true false
false
1 AB
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła