JavaScript интерфейс Node

Описание интерфейса

Классы DOM образуют иерархию в которой интерфейс Node находится вверху, от него наследуется несколько типов объектов DOM API, что позволяет обрабатывать эти типы аналогично.

Интерфейс Node предоставляет свойства и методы для выполнения манипуляций с деревом DOM. Все объекты в дереве документа (включая сам объект Document) наследуют интерфейс Node.

Ниже представлен перечень основных интерфейсов, которые полностью наследуют от интерфейса Node его методы и свойства:

Document
Element
CharacterData и его потомки Text, CDATASection и Comment
Attr
ProcessingInstruction
DocumentFragment
DocumentType

Методы интерфейса

Методы экземпляра Node
Метод	Описание
`appendChild()`	Позволяет добавить узел в конец списка дочерних элементов указанного родительского узла.
`cloneNode()`	Создает и возвращает копию узла, для которого он был вызван.
`compareDocumentPosition()`	Метод позволяет сравнить положение текущего узла с положением другого узла, и возвратить целое число, которое описывает, где они находятся в документе по отношению друг к другу.
`contains()`	Возвращает `true`, если аргумент — сам узел или его потомок; для `null` возвращает `false`.
`getRootNode()`	Возвращает корень дерева узла. При вызове с параметром `{ composed: true }` проходит через теневые корни к корню содержащего дерева.
`hasChildNodes()`	Возвращает логическое значение, которое указывает на то есть ли у элемента дочерние узлы, или нет.
`insertBefore()`	Позволяет вставить необходимый узел перед заданным узлом в качестве дочернего узла указанного родительского узла.
`isDefaultNamespace()`	Возвращает логическое значение, которое указывает на то является ли URI пространства имен, переданное в качестве аргумента пространством имен по умолчанию для данного узла, или нет.
`isEqualNode()`	Возвращает логическое значение, указывающее, являются ли два узла идентичными (имеют один и тот же тип, имя тега, атрибуты и дочерние узлы).
`isSameNode()`	Возвращает логическое значение, указывающее, являются ли два узла одинаковыми (ссылаются на один и тот же объект).
`lookupNamespaceURI()`	Метод принимает префикс пространства имен и возвращает URI адрес пространства имен, связанного с ним на данном узле, или `null`, если такой префикс не определен.
`lookupPrefix()`	Возвращает в виде строки (`DOMString`) префикс для данного URI пространства имен, если она существует, и `null`, если нет.
`normalize()`	Позволяет очистить все текстовые узлы под этим элементом (объединяет соседние, удаляет пустые).
`removeChild()`	Позволяет удалить дочерний узел из дерева DOM.
`replaceChild()`	Позволяет заменить один дочерний узел указанного узла другим.

Свойства интерфейса

Свойства экземпляра Node
Свойство	Описание
`baseURI`	Строка базового URL документа узла; только чтение, может меняться при изменении базового адреса.
`childNodes`	Живой `NodeList` всех непосредственных дочерних узлов, включая текст и комментарии; только чтение.
`firstChild`	Возвращает узел, представляющий из себя первый прямой дочерний узел указанного узла, или `null`, если указанный узел не имеет детей.
`isConnected`	Логический признак соединения с Document через обычное или теневое дерево. Узел внутри ShadowRoot отсоединённого хоста имеет false; одно лишь наличие теневого корня не означает подключения.
`lastChild`	Возвращает узел, представляющий из себя последний прямой дочерний узел указанного узла, или `null`, если указанный узел не имеет детей.
`nextSibling`	Возвращает дочерний узел следующий за указанным узлом внутри родительского элемента, или `null`, если указанный узел является последним дочерним узлом в родительском элементе.
`nodeName`	Возвращает строку (`DOMString`), содержащую имя текущего узла.
`nodeType`	Возвращает числовое значение (целочисленный тип `unsigned short`), представляющее тип узла.
`nodeValue`	Позволяет получить, или установить значение текущего узла.
`ownerDocument`	Возвращает документ (объект `Document`), которому принадлежит этот узел. В том случае, если узел сам является документом, то возвращаемое значение будет соответствовать значению `null`.
`parentElement`	Возвращает элемент, который является родителем данного узла. В том случае, если узел не имеет родителя, или родитель не является элементом, то это свойство вернет значение `null`.
`parentNode`	Родительский узел (`Node`) или `null`, если родителя нет; родителем может быть `Document` или `DocumentFragment`.
`previousSibling`	Возвращает дочерний узел предшествующий указанному узлу внутри родительского элемента, или `null`, если указанный узел является первым дочерним узлом в родительском элементе.
`textContent`	Возвращает, или задает текстовое содержимое элемента и всех его потомков.

Собственные члены Node перечислены выше; методы событий наследуются от EventTarget. innerText относится к HTMLElement. Константы типов узлов и битовые флаги положения доступны на Node и его прототипе; их значения приведены в статьях nodeType и compareDocumentPosition().

На прототипе интерфейса определено символьное свойство Symbol.toStringTag со строковым именем интерфейса; оно используется при строковом представлении через Object.prototype.toString.

Спецификация

DOM Standard.