Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Node — uzel DOM

Node je společné rozhraní pro uzly DOM, včetně elementů a textu. Umožňuje zkoumat vztahy ve stromu, číst typ uzlu a měnit jeho potomky.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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 představuje uzel DOM, nejen element. nodeType rozlišuje mimo jiné Node.ELEMENT_NODE (1) a Node.TEXT_NODE (3). nodeValue zpřístupňuje textová či komentářová data a hodnoty atributů, ale pro element vrací null; přiřazení hodnoty elementu nic nezmění.

childNodes je živá kolekce NodeList všech přímých potomků, včetně textových uzlů obsahujících bílé znaky a komentářů. Změny stromu kolekci aktualizují. firstChild vrací prvního potomka libovolného typu, nebo null. parentNode vrací rodiče, nebo null; parentElement vrací tohoto rodiče pouze tehdy, jde-li o element, jinak vrací null.

contains(other) ověřuje, zda je other stejný uzel nebo jeho potomek; pro null vrací false. Nepřekračuje hranici stínového stromu. isConnected označuje připojení k dokumentu, a to i přes stínový strom, nikoli viditelnost na obrazovce.

insertBefore(newNode, referenceNode) vrací newNode. Pokud je newNode objekt typu DocumentFragment, metoda vloží jeho přímé potomky místo samotného fragmentu a vrátí tentýž, nyní prázdný fragment. Jinak vloží samotný newNode. Referenční uzel musí být přímým potomkem; explicitní null označuje konec seznamu. Existující uzel se přesune, nikoli zkopíruje. Neplatný rodič referenčního uzlu způsobí NotFoundError a nepovolená hierarchie způsobí HierarchyRequestError. normalize() odstraní prázdné běžné uzly Text v podstromu a sloučí sousední běžné uzly Text, přičemž v každé slučované posloupnosti zachová první neprázdný uzel. Uzly CDATASection neodstraňuje ani neslučuje, ani když jsou prázdné; tyto uzly oddělují posloupnosti běžných uzlů Text. Z neprázdného textu bílé znaky neodstraňuje.

Příklad spusťte v prohlížeči s DOM. Použití Node 24 v repozitáři samo o sobě nepotvrzuje podporu tohoto rozhraní prohlížeče.

Referenční identifikátory zahrnuté v tomto hesle: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Příklady

(() => {
  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);
})();

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje