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