База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Node — DOM възел

Node е общият интерфейс за DOM възлите, включително елементите и текста. С него могат да се проверяват връзките в дървото, да се прочита типът на възела и да се променят децата му.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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 представлява DOM възел, а не само елемент. nodeType разграничава, наред с други, Node.ELEMENT_NODE (1) и Node.TEXT_NODE (3). nodeValue предоставя текстови данни или данни от коментар и стойности на атрибути, но връща null за елемент; присвояването на стойност на елемент не променя нищо.

childNodes е жива колекция NodeList на всички преки деца, включително текстови възли с празни знаци и коментари. Промените в дървото актуализират колекцията. firstChild връща първото дете от произволен тип или null. parentNode връща родителя или null; parentElement връща този родител само ако е елемент, иначе връща null.

contains(other) проверява дали other е същият възел или негов наследник; за null връща false. Не преминава границата на shadow tree. isConnected показва връзка с документ, включително чрез shadow tree, а не видимост на екрана.

insertBefore(newNode, referenceNode) връща newNode. Ако newNode е DocumentFragment, методът вмъква децата на фрагмента вместо самия фрагмент и връща същия фрагмент, който вече е празен. В противен случай вмъква самия newNode. Референтният възел трябва да е пряко дете; изрично null означава края на списъка. Съществуващ възел се премества, а не се копира. Невалиден родител на референтния възел причинява NotFoundError, а недопустима йерархия — HierarchyRequestError. normalize() премахва празните обикновени възли Text в поддървото и слива съседните обикновени възли Text, като запазва първия непразен възел във всяка слята поредица. Методът не премахва и не слива възлите CDATASection, дори когато са празни; те разделят поредиците от обикновени възли Text. Методът не премахва празните знаци от непразен текст.

Изпълнете примера в браузър с DOM. Използването на Node 24 в хранилище само по себе си не доказва поддръжка на този API на браузъра.

Референтни идентификатори, обхванати в тази статия: Node.contains, Node.firstChild, Node.parentElement, Node.insertBefore, Node.normalize, Node.parentNode, Node.isConnected, Node.nodeType, Node.nodeValue, Node.childNodes.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници