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_NODENode представлява 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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.