Интерфейс Node

Все известные подинтерфейсы:: Attr, CDATASection, CharacterData, Comment, Document, DocumentFragment, DocumentType, Element, Entity, EntityReference, HTMLAnchorElement, HTMLAppletElement, HTMLAreaElement, HTMLBaseElement, HTMLBaseFontElement, HTMLBodyElement, HTMLBRElement, HTMLButtonElement, HTMLDirectoryElement, HTMLDivElement, HTMLDListElement, HTMLDocument, HTMLElement, HTMLFieldSetElement, HTMLFontElement, HTMLFormElement, HTMLFrameElement, HTMLFrameSetElement, HTMLHeadElement, HTMLHeadingElement, HTMLHRElement, HTMLHtmlElement, HTMLIFrameElement, HTMLImageElement, HTMLInputElement, HTMLIsIndexElement, HTMLLabelElement, HTMLLegendElement, HTMLLIElement, HTMLLinkElement, HTMLMapElement, HTMLMenuElement, HTMLMetaElement, HTMLModElement, HTMLObjectElement, HTMLOListElement, HTMLOptGroupElement, HTMLOptionElement, HTMLParagraphElement, HTMLParamElement, HTMLPreElement, HTMLQuoteElement, HTMLScriptElement, HTMLSelectElement, HTMLStyleElement, HTMLTableCaptionElement, HTMLTableCellElement, HTMLTableColElement, HTMLTableElement, HTMLTableRowElement, HTMLTableSectionElement, HTMLTextAreaElement, HTMLTitleElement, HTMLUListElement, Notation, ProcessingInstruction, Text, XPathNamespace

Все известные реализующие классы:: IIOMetadataNode

public interface Node

Интерфейс Node является основным типом данных для всей модели объекта документа. Он представляет собой отдельный узел в дереве документа. В то время как все объекты, реализующие интерфейс Node, предоставляют методы для работы с дочерними элементами, не все объекты, реализующие интерфейс Node, могут иметь дочерние элементы. Например, узлы Text могут не иметь дочерних элементов, а добавление дочерних элементов к таким узлам приводит к возникновению исключения DOMException.

Атрибуты nodeName, nodeValue и attributes включены в качестве механизма для получения информации об узлах без приведения к конкретному производному интерфейсу. В тех случаях, когда для конкретного интерфейса nodeType (например, nodeValue для Element или attributes для Comment ) нет очевидного соответствия этих атрибутов, возвращается null. Обратите внимание, что специализированные интерфейсы могут содержать дополнительные и более удобные механизмы получения и установки соответствующей информации.

Значения nodeName, nodeValue и attributes варьируются в зависимости от типа узла следующим образом:

Таблица интерфейса
Интерфейс	nodeName	nodeValue	атрибуты
`Attr`	то же, что и `Attr.name`	то же, что и `Attr.value`	`null`
`CDATASection`	`"#cdata-section"`	то же, что и `CharacterData.data`, содержимое раздела CDATA	`null`
`Comment`	`"#comment"`	то же, что и `CharacterData.data`, содержимое комментария	`null`
`Document`	`"#document"`	`null`	`null`
`DocumentFragment`	`"#document-fragment"`	`null`	`null`
`DocumentType`	то же, что и `DocumentType.name`	`null`	`null`
`Element`	то же, что и `Element.tagName`	`null`	`NamedNodeMap`
`Entity`	имя сущности	`null`	`null`
`EntityReference`	имя ссылаемой сущности	`null`	`null`
`Notation`	имя обозначения	`null`	`null`
`ProcessingInstruction`	то же, что и `ProcessingInstruction.target`	то же, что и `ProcessingInstruction.data`	`null`
`Text`	`"#text"`	то же, что и `CharacterData.data`, содержимое текстового узла	`null`

См. также Спецификацию уровня 3 ядра объектной модели документа (DOM).

С тех пор как:: 1.4, DOM Level 2

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final short`	`ATTRIBUTE_NODE`	Узел является `Attr`.
`static final short`	`CDATA_SECTION_NODE`	Узел является `CDATASection`.
`static final short`	`COMMENT_NODE`	Узел является `Comment`.
`static final short`	`DOCUMENT_FRAGMENT_NODE`	Узел является `DocumentFragment`.
`static final short`	`DOCUMENT_NODE`	Узел является `Document`.
`static final short`	`DOCUMENT_POSITION_CONTAINED_BY`	Узел содержится в узле-ссылке.
`static final short`	`DOCUMENT_POSITION_CONTAINS`	Узел содержит узел-ссылку.
`static final short`	`DOCUMENT_POSITION_DISCONNECTED`	Два узла не соединены.
`static final short`	`DOCUMENT_POSITION_FOLLOWING`	Узел следует за узлом-ссылкой.
`static final short`	`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC`	Определение предшествующего и последующего узлов зависит от реализации.
`static final short`	`DOCUMENT_POSITION_PRECEDING`	Второй узел предшествует узлу-ссылке.
`static final short`	`DOCUMENT_TYPE_NODE`	Узел является `DocumentType`.
`static final short`	`ELEMENT_NODE`	Узел является `Element`.
`static final short`	`ENTITY_NODE`	Узел является `Entity`.
`static final short`	`ENTITY_REFERENCE_NODE`	Узел является `EntityReference`.
`static final short`	`NOTATION_NODE`	Узел является `Notation`.
`static final short`	`PROCESSING_INSTRUCTION_NODE`	Узел является `ProcessingInstruction`.
`static final short`	`TEXT_NODE`	Узел является узлом `Text`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Node`	`appendChild(Node newChild)`	Добавляет узел `newChild` в конец списка дочерних узлов этого узла.
`Node`	`cloneNode(boolean deep)`	Возвращает дубликат этого узла, т.е. служит универсальным конструктором копирования для узлов.
`short`	`compareDocumentPosition(Node other)`	Сравнивает узел-ссылку (т.е. узел, на котором вызывается этот метод) с узлом (т.е. переданным в качестве параметра) относительно их позиции в документе и в соответствии с порядком документа.
`NamedNodeMap`	`getAttributes()`	`NamedNodeMap`, содержащий атрибуты этого узла (если это `Element`) или `null` в противном случае.
`String`	`getBaseURI()`	Абсолютный базовый URI этого узла или `null`, если реализация не смогла получить абсолютный URI.
`NodeList`	`getChildNodes()`	`NodeList`, содержащий всех дочерних узлов этого узла.
`Object`	`getFeature(String feature, String version)`	Этот метод возвращает специализированный объект, реализующий специализированные API указанного функционального блока и версии, как указано в .
`Node`	`getFirstChild()`	Первый дочерний узел этого узла.
`Node`	`getLastChild()`	Последний дочерний узел этого узла.
`String`	`getLocalName()`	Возвращает локальную часть квалифицированного имени этого узла.
`String`	`getNamespaceURI()`	URI пространства имён этого узла или `null`, если он не указан (см. ).
`Node`	`getNextSibling()`	Узел, непосредственно следующий за этим узлом.
`String`	`getNodeName()`	Имя этого узла, в зависимости от его типа; см. таблицу выше.
`short`	`getNodeType()`	Код, представляющий тип базового объекта, как определено выше.
`String`	`getNodeValue()`	Значение этого узла, в зависимости от его типа; см. таблицу выше.
`Document`	`getOwnerDocument()`	Объект `Document`, связанный с этим узлом.
`Node`	`getParentNode()`	Родитель этого узла.
`String`	`getPrefix()`	Префикс пространства имен этого узла или `null`, если он не указан.
`Node`	`getPreviousSibling()`	Узел, непосредственно предшествующий этому узлу.
`String`	`getTextContent()`	Этот атрибут возвращает текстовое содержимое этого узла и его потомков.
`Object`	`getUserData(String key)`	Получает объект, связанный с ключом в этом узле.
`boolean`	`hasAttributes()`	Возвращает, есть ли у этого узла (если он является элементом) какие-либо атрибуты.
`boolean`	`hasChildNodes()`	Возвращает, есть ли у этого узла какие-либо дочерние узлы.
`Node`	`insertBefore(Node newChild, Node refChild)`	Вставляет узел `newChild` перед существующим дочерним узлом `refChild`.
`boolean`	`isDefaultNamespace(String namespaceURI)`	Этот метод проверяет, является ли указанное `namespaceURI` стандартным пространством имен или нет.
`boolean`	`isEqualNode(Node arg)`	Проверяет, равны ли два узла.
`boolean`	`isSameNode(Node other)`	Возвращает, является ли этот узел тем же узлом, что и заданный.
`boolean`	`isSupported(String feature, String version)`	Проверяет, реализует ли реализация DOM определенный функциональный блок и поддерживает ли этот функциональный блок этот узел, как указано в .
`String`	`lookupNamespaceURI(String prefix)`	Ищет URI пространства имен, связанный с данным префиксом, начиная с этого узла.
`String`	`lookupPrefix(String namespaceURI)`	Ищет префикс, связанный с данным URI пространства имен, начиная с этого узла.
`void`	`normalize()`	Приводит все узлы `Text` в полную глубину поддерева под этим узлом `Node`, включая узлы атрибутов, к "нормальной" форме, где только структура (например, элементы, комментарии, инструкции обработки, секции CDATA и ссылки на сущности) отделяет узлы `Text`, т.е. нет ни соседних узлов `Text`, ни пустых узлов `Text`.
`Node`	`removeChild(Node oldChild)`	Удаляет дочерний узел, указанный в `oldChild`, из списка дочерних узлов и возвращает его.
`Node`	`replaceChild(Node newChild, Node oldChild)`	Заменяет дочерний узел `oldChild` на `newChild` в списке дочерних узлов и возвращает узел `oldChild`.
`void`	`setNodeValue(String nodeValue)`	Значение этого узла, в зависимости от его типа; см. таблицу выше.
`void`	`setPrefix(String prefix)`	Префикс пространства имен этого узла, или `null`, если он не указан.
`void`	`setTextContent(String textContent)`	Этот атрибут возвращает текстовое содержимое этого узла и его потомков.
`Object`	`setUserData(String key, Object data, UserDataHandler handler)`	Связывает объект с ключом в этом узле.

Подробное описание полей

ELEMENT_NODE

static final short ELEMENT_NODE

Узел является узлом Element.

См. также:

ATTRIBUTE_NODE

static final short ATTRIBUTE_NODE

Узел является узлом Attr.

См. также:

TEXT_NODE

static final short TEXT_NODE

Узел является узлом типа Text.

См. также:

CDATA_SECTION_NODE

static final short CDATA_SECTION_NODE

Узел является узлом CDATASection.

См. также:

ENTITY_REFERENCE_NODE

static final short ENTITY_REFERENCE_NODE

Узел является узлом EntityReference.

См. также:

ENTITY_NODE

static final short ENTITY_NODE

Узел является узлом Entity.

См. также:

PROCESSING_INSTRUCTION_NODE

static final short PROCESSING_INSTRUCTION_NODE

Узел является узлом ProcessingInstruction.

См. также:

COMMENT_NODE

static final short COMMENT_NODE

Узел является узлом Comment.

См. также:

DOCUMENT_NODE

static final short DOCUMENT_NODE

Узел является узлом Document.

См. также:

DOCUMENT_TYPE_NODE

static final short DOCUMENT_TYPE_NODE

Узел является узлом DocumentType.

См. также:

DOCUMENT_FRAGMENT_NODE

static final short DOCUMENT_FRAGMENT_NODE

Узел является узлом DocumentFragment.

См. также:

NOTATION_NODE

static final short NOTATION_NODE

Узел является узлом Notation.

См. также:

DOCUMENT_POSITION_DISCONNECTED

static final short DOCUMENT_POSITION_DISCONNECTED

Два узла отключены. Порядок между отключенными узлами всегда зависит от реализации.

См. также:

DOCUMENT_POSITION_PRECEDING

static final short DOCUMENT_POSITION_PRECEDING

Второй узел предшествует узлу-ссылке.

См. также:

DOCUMENT_POSITION_FOLLOWING

static final short DOCUMENT_POSITION_FOLLOWING

Узел следует за узлом-ссылкой.

См. также:

DOCUMENT_POSITION_CONTAINS

static final short DOCUMENT_POSITION_CONTAINS

Узел содержит узел-ссылку. Узел-содержимое всегда предшествует тоже.

См. также:

DOCUMENT_POSITION_CONTAINED_BY

static final short DOCUMENT_POSITION_CONTAINED_BY

Узел содержится внутри узла-ссылки. Вложенный узел всегда следует тоже.

См. также:

DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

static final short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

Определение предшествующего/следующего узла зависит от реализации.

См. также:

Подробное описание методов

getNodeName

String getNodeName()

Имя этого узла, в зависимости от его типа; см. таблицу выше.

getNodeValue

String getNodeValue() throws DOMException

Значение этого узла, в зависимости от его типа; см. таблицу выше. Если оно определено как null, его установка не повлияет, в том числе, если узел является только для чтения.

Возбуждает:: DOMException - DOMSTRING_SIZE_ERR: Возникает, когда возвращаются больше символов, чем может вместить переменная типа DOMString на платформе реализации.

setNodeValue

void setNodeValue(String nodeValue) throws DOMException

Возбуждает:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Возникает, когда узел только для чтения и не определен как null.

getNodeType

short getNodeType()

Код, представляющий тип базового объекта, как определено выше.

getParentNode

Node getParentNode()

Родительский узел. Все узлы, кроме Attr, Document, DocumentFragment, Entity и Notation, могут иметь родителя. Однако, если узел только что создан и еще не добавлен в дерево, или если он был удален из дерева, это значение null.

getChildNodes

NodeList getChildNodes()

Объект NodeList, содержащий всех потомков этого узла. Если потомков нет, это пустой объект NodeList.

getFirstChild

Node getFirstChild()

Первый потомок этого узла. Если такого узла нет, возвращает null.

getLastChild

Node getLastChild()

Последний потомок этого узла. Если такого узла нет, возвращает null.

getPreviousSibling

Node getPreviousSibling()

Узел, непосредственно предшествующий этому узлу. Если такого узла нет, возвращается null.

getNextSibling

Node getNextSibling()

Узел, непосредственно следующий за этим узлом. Если такого узла нет, возвращается null.

getAttributes

NamedNodeMap getAttributes()

Объект, содержащий атрибуты этого узла (если это атрибутивный узел) или null в противном случае.

getOwnerDocument

Document getOwnerDocument()

Объект документа, связанный с этим узлом. Это также объект документа, используемый для создания новых узлов. Когда этот узел является Document или DocumentType, который еще не используется с каким-либо Document, это null.

Since:: 1.4, DOM Level 2

insertBefore

Node insertBefore(Node newChild, Node refChild) throws DOMException

Вставляет узел newChild перед существующим дочерним узлом refChild. Если refChild является null, вставьте newChild в конец списка дочерних элементов.
Если newChild является фрагментом документа, все его дочерние элементы вставляются в том же порядке перед refChild. Если узел newChild уже находится в дереве, он сначала удаляется.

Примечание: Вставка узла перед самим собой зависит от реализации.

Parameters:: newChild - Вставляемый узел.; refChild - Ссылка на узел, т.е. узел, перед которым должен быть вставлен новый узел.
Returns:: Вставляемый узел.
Throws:: DOMException - HIERARCHY_REQUEST_ERR: Возникает, если этот узел имеет тип, не допускающий дочерних элементов типа узла newChild, или если вставляемый узел является предком этого узла или самим этим узлом, или если этот узел имеет тип Document, и приложение DOM пытается вставить второй узел DocumentType или Element.
WRONG_DOCUMENT_ERR: Возникает, если newChild был создан из другого документа, чем документ, создавший этот узел.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если этот узел является только для чтения или если родитель вставляемого узла является только для чтения.
NOT_FOUND_ERR: Возникает, если refChild не является дочерним элементом этого узла.
NOT_SUPPORTED_ERR: если этот узел имеет тип Document, это исключение может возникнуть, если реализация DOM не поддерживает вставку узла DocumentType или Element.
Since:: 1.4, DOM Level 3

replaceChild

Node replaceChild(Node newChild, Node oldChild) throws DOMException

Заменяет дочерний узел oldChild узлом newChild в списке дочерних элементов и возвращает узел oldChild.
Если newChild является фрагментом документа, то oldChild заменяется всеми его дочерними узлами, которые вставляются в том же порядке. Если узел newChild уже находится в дереве, он сначала удаляется.

Примечание: Замена узла самим собой зависит от реализации.

Parameters:: newChild - Новый узел, который нужно поместить в список дочерних элементов.; oldChild - Узел, который заменяется в списке.
Returns:: Заменённый узел.
Throws:: DOMException - HIERARCHY_REQUEST_ERR: Возникает, если этот узел имеет тип, не допускающий дочерних элементов типа узла newChild, или если узел для замены является предком этого узла или самим этим узлом, или если этот узел имеет тип Document, и результат операции замены добавит второй узел DocumentType или Element в узел Document.
WRONG_DOCUMENT_ERR: Возникает, если newChild был создан из другого документа, чем документ, создавший этот узел.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если этот узел или родитель нового узла является только для чтения.
NOT_FOUND_ERR: Возникает, если oldChild не является дочерним элементом этого узла.
NOT_SUPPORTED_ERR: если этот узел имеет тип Document, это исключение может быть вызвано, если реализация DOM не поддерживает замену дочернего элемента DocumentType или дочернего элемента Element.
Since:: 1.4, DOM Level 3

removeChild

Node removeChild(Node oldChild) throws DOMException

Удаляет дочерний узел, указанный в oldChild, из списка дочерних элементов и возвращает его.

Parameters:: oldChild - Удаляемый узел.
Returns:: Удаленный узел.
Throws:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Возникает, если этот узел является только для чтения.
NOT_FOUND_ERR: Возникает, если oldChild не является дочерним элементом этого узла.
NOT_SUPPORTED_ERR: если этот узел имеет тип Document, это исключение может возникнуть, если реализация DOM не поддерживает удаление дочернего узла DocumentType или дочернего узла Element.
Since:: 1.4, DOM Level 3

appendChild

Node appendChild(Node newChild) throws DOMException

Добавляет узел newChild в конец списка дочерних элементов этого узла. Если узел newChild уже находится в дереве, он сначала удаляется.

Parameters:: newChild - Узел для добавления. Если это фрагмент документа, всё содержимое фрагмента перемещается в список дочерних элементов этого узла
Returns:: Добавленный узел.
Throws:: DOMException - HIERARCHY_REQUEST_ERR: Возникает, если этот узел имеет тип, не допускающий дочерних элементов типа узла newChild, или если добавляемый узел является предком этого узла или самим этим узлом, или если этот узел имеет тип Document, и приложение DOM пытается добавить второй узел DocumentType или Element.
WRONG_DOCUMENT_ERR: Возникает, если newChild был создан из другого документа, чем документ, создавший этот узел.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если этот узел или предыдущий родитель вставляемого узла является только для чтения.
NOT_SUPPORTED_ERR: если узел newChild является дочерним элементом узла Document, это исключение может возникнуть, если реализация DOM не поддерживает удаление дочернего узла DocumentType или дочернего узла Element.
Since:: 1.4, DOM Level 3

hasChildNodes

boolean hasChildNodes()

Возвращает, содержит ли этот узел какие-либо дочерние элементы.

Returns:: Возвращает true, если у этого узла есть дочерние элементы, false в противном случае.

cloneNode

Node cloneNode(boolean deep)

Возвращает дубликат этого узла, то есть служит универсальным конструктором копирования для узлов. Дублирующий узел не имеет родителя (parentNode равен null) и данных пользователя. Данные пользователя, связанные с импортированным узлом, не переносятся. Однако, если были указаны обработчики UserDataHandlers вместе с соответствующими данными, эти обработчики будут вызваны с соответствующими параметрами перед возвратом этого метода.
Клонирование Element копирует все атрибуты и их значения, включая те, которые сгенерированы процессором XML для представления атрибутов по умолчанию, но этот метод не копирует никакие дочерние элементы, если это не глубокое клонирование. Это включает текст, содержащийся в узле Element, так как текст содержится в дочернем текстовом узле Text. Клонирование Attr напрямую, в отличие от клонирования в рамках операции клонирования Element, возвращает указанный атрибут (specified равен true). Клонирование Attr всегда клонирует его дочерние элементы, так как они представляют его значение, независимо от того, является ли это глубоким клонированием или нет. Клонирование EntityReference автоматически строит его поддерево, если соответствующий Entity доступен, независимо от того, является ли это глубоким клонированием или нет. Клонирование любого другого типа узла просто возвращает копию этого узла.
Обратите внимание, что клонирование неизменяемого поддерева приводит к изменяемой копии, но дочерние элементы узла EntityReference клонирования являются только для чтения. Кроме того, клонирование неопределённых узлов Attr задаются. И, клонирование узлов Document, DocumentType, Entity и Notation зависит от реализации.

Parameters:: deep - Если true, рекурсивно клонировать поддерево под указанным узлом; если false, клонировать только сам узел (и его атрибуты, если это атрибутивный узел).
Returns:: Дублирующий узел.

normalize

void normalize()

Размещает все Text узлы на полной глубине поддерева под этим Node, включая узлы атрибутов, в «нормальной» форме, где только структура (например, элементы, комментарии, инструкции обработки, разделы CDATA и ссылки на сущности) отделяет Text узлы, то есть нет ни смежных Text узлов, ни пустых Text узлов. Это можно использовать для обеспечения того, чтобы представление DOM документа было таким же, как если бы оно было сохранено и перезагружено, и это полезно, когда используются операции (например, запросы XPointer [XPointer]), которые зависят от конкретной структуры дерева документов. Если параметр «normalize-characters» объекта DOMConfiguration, прикрепленного к Node.ownerDocument, равен true, этот метод также полностью нормализует символы Text узлов.

Примечание: В случаях, когда документ содержит CDATASections, операции нормализации может быть недостаточно, поскольку XPointer не различает Text узлы и CDATASection узлы.

Since:: 1.4, DOM Level 3

isSupported

boolean isSupported(String feature, String version)

Проверяет, реализует ли реализация DOM определенный функциональный блок и поддерживает ли этот функциональный блок данный узел, как указано в .

Parameters:: feature - Имя проверяемого функционального блока.; version - Номер версии функционального блока для проверки.
Returns:: Возвращает true, если указанный функциональный блок поддерживается этим узлом, false в противном случае.
Since:: 1.4, DOM Level 2

getNamespaceURI

String getNamespaceURI()

URI пространства имен этого узла или null, если он не указан (см. ).
Это не вычисленное значение, которое является результатом поиска пространства имен на основе анализа деклараций пространств имен в области видимости. Это просто URI пространства имен, заданный во время создания.
Для узлов любого типа, кроме ELEMENT_NODE и ATTRIBUTE_NODE, и узлов, созданных с помощью метода DOM Level 1, такого как Document.createElement(), это всегда null.

Примечание: Согласно спецификации Namespaces in XML [XML Namespaces], атрибут не наследует пространство имен от элемента, к которому он прикреплен. Если атрибуту явно не задано пространство имен, у него просто нет пространства имен.

Since:: 1.4, DOM Level 2

getPrefix

String getPrefix()

Префикс пространства имен этого узла или null, если он не указан. Когда он определен как null, его установка не оказывает влияния, включая случай, если узел является только для чтения.
Обратите внимание, что установка этого атрибута, если это разрешено, изменяет атрибут nodeName, который содержит полное имя, а также атрибуты tagName и name интерфейсов Element и Attr, когда это применимо.
Установка префикса в null делает его неопределённым, установка в пустую строку зависит от реализации.
Обратите также внимание, что изменение префикса атрибута, который, как известно, имеет значение по умолчанию, не приводит к появлению нового атрибута со значением по умолчанию и исходным префиксом, так как namespaceURI и localName не изменяются.
Для узлов любого типа, кроме ELEMENT_NODE и ATTRIBUTE_NODE, и узлов, созданных с помощью метода DOM Level 1, такого как createElement из интерфейса Document, это всегда null.

Since:: 1.4, DOM Level 2

setPrefix

void setPrefix(String prefix) throws DOMException

Throws:: DOMException - INVALID_CHARACTER_ERR: Вызывается, если указанный префикс содержит недопустимый символ в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.
NO_MODIFICATION_ALLOWED_ERR: Вызывается, если этот узел является только для чтения.
NAMESPACE_ERR: Вызывается, если указанный prefix имеет неверный формат в соответствии со спецификацией Namespaces in XML, если namespaceURI этого узла равен null, если указанный префикс равен «xml», и namespaceURI этого узла отличается от " http://www.w3.org/XML/1998/namespace", если этот узел является атрибутом и указанный префикс равен «xmlns», и namespaceURI этого узла отличается от "http://www.w3.org/2000/xmlns/", или если этот узел является атрибутом и qualifiedName этого узла равен «xmlns» [XML Namespaces] .
Since:: 1.4, DOM Level 2

getLocalName

String getLocalName()

Возвращает локальную часть полного имени этого узла.
Для узлов любого типа, кроме ELEMENT_NODE и ATTRIBUTE_NODE, и узлов, созданных с помощью метода DOM Level 1, такого как Document.createElement(), это всегда null.

Since:: 1.4, DOM Level 2

hasAttributes

boolean hasAttributes()

Возвращает, имеет ли этот узел (если он является элементом) какие-либо атрибуты.

Returns:: Возвращает true, если у этого узла есть атрибуты, false в противном случае.
Since:: 1.4, DOM Level 2

getBaseURI

String getBaseURI()

Абсолютный базовый URI этого узла или null, если реализация не смогла получить абсолютный URI. Это значение вычисляется, как описано в . Однако, когда Document поддерживает функциональный блок «HTML» [DOM Level 2 HTML], базовый URI вычисляется с использованием сначала значения атрибута href элемента HTML BASE, если он есть, а затем значения атрибута documentURI из интерфейса Document в противном случае.

Since:: 1.5, DOM Level 3

compareDocumentPosition

short compareDocumentPosition(Node other) throws DOMException

Сравнивает узел-ссылку, т.е. узел, на котором вызывается этот метод, с узлом, т.е. переданным в качестве параметра, относительно их положения в документе и в соответствии с порядком документа.

Parameters:: other - Узел для сравнения с узлом-ссылкой.
Returns:: Возвращает, как позиционируется узел относительно узла-ссылки.
Throws:: DOMException - NOT_SUPPORTED_ERR: когда сравниваемые узлы происходят из разных реализаций DOM, которые не согласованы для возвращения согласованных результатов, специфичных для реализации.
Since:: 1.5, DOM Level 3

getTextContent

String getTextContent() throws DOMException

Этот атрибут возвращает текстовое содержимое этого узла и его потомков. Когда он определен как null, его установка не оказывает влияния. При установке любые возможные дочерние узлы этого узла удаляются, и, если новая строка не пуста или null, заменяется одним Text узлом, содержащим строку, которой был задан этот атрибут.
При получении не выполняется сериализация, возвращаемая строка не содержит никакого разметки. Не выполняется нормализация пробелов, и возвращаемая строка не содержит пробелов в содержании элемента (см. атрибут Text.isElementContentWhitespace). Аналогично, при установке также не выполняется разбор, входная строка воспринимается как чистое текстовое содержимое.
Возвращаемая строка состоит из текстового содержимого этого узла в зависимости от его типа, как определено ниже:

Таблица узел/содержимое
Тип узла	Содержимое
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE	конкатенация значения атрибута `textContent` каждого дочернего узла, за исключением узлов COMMENT_NODE и PROCESSING_INSTRUCTION_NODE. Это пустая строка, если у узла нет дочерних узлов.
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE	`nodeValue`
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE	null

Throws:: DOMException - DOMSTRING_SIZE_ERR: Вызывается, когда возвращается больше символов, чем помещается в переменную DOMString на платформе реализации.
Since:: 1.5, DOM Level 3

END_OF_DOCUMENT_MARKER

setTextContent

void setTextContent(String textContent) throws DOMException

Этот атрибут возвращает текстовое содержимое этого узла и его потомков. Когда он определён как null, его установка не оказывает никакого эффекта. При установке любые возможные дочерние узлы этого узла удаляются и, если новая строка не пуста или null, заменяются одним Text узлом, содержащим строку, которой был задан этот атрибут.
При получении не выполняется сериализация, возвращаемая строка не содержит никакого разметки. Не выполняется нормализация пробелов, и возвращаемая строка не содержит пробелов в содержимом элемента (см. атрибут Text.isElementContentWhitespace). Аналогично, при установке не выполняется парсинг, входная строка воспринимается как чистое текстовое содержимое.
Возвращаемая строка состоит из текстового содержимого этого узла в зависимости от его типа, как определено ниже:

Таблица узлов/содержимого
Тип узла	Содержимое
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE	конкатенация значения атрибута `textContent` каждого дочернего узла, исключая узлы COMMENT_NODE и PROCESSING_INSTRUCTION_NODE. Это пустая строка, если у узла нет дочерних узлов.
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE	`nodeValue`
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE	null

Throws:: DOMException - NO_MODIFICATION_ALLOWED_ERR: Возникает, когда узел является только для чтения.
Since:: 1.5, DOM Level 3

isSameNode

boolean isSameNode(Node other)

Возвращает, является ли этот узел тем же узлом, что и заданный.
Этот метод предоставляет способ определить, ссылаются ли две Node ссылки, возвращённые реализацией, на один и тот же объект. Когда две Node ссылки являются ссылками на один и тот же объект, даже если через прокси, ссылки могут использоваться полностью взаимозаменяемо, так что все атрибуты имеют одинаковые значения, и вызов одного и того же метода DOM на любой ссылке всегда имеет точно такой же эффект.

Parameters:: other - Узел для проверки.
Returns:: Возвращает true, если узлы одинаковые, false в противном случае.
Since:: 1.5, DOM Level 3

lookupPrefix

String lookupPrefix(String namespaceURI)

Ищет префикс, связанный с данным URI пространства имён, начиная с этого узла. Объявления пространства имён по умолчанию игнорируются этим методом.
См. для получения подробной информации об алгоритме, используемом этим методом.

Parameters:: namespaceURI - URI пространства имён для поиска.
Returns:: Возвращает связанный префикс пространства имён, если найден, или null, если не найден. Если более одного префикса связаны с префиксом пространства имён, возвращаемый префикс пространства имён зависит от реализации.
Since:: 1.5, DOM Level 3

isDefaultNamespace

boolean isDefaultNamespace(String namespaceURI)

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

Parameters:: namespaceURI - URI пространства имён для поиска.
Returns:: Возвращает true, если указанное namespaceURI является пространством имён по умолчанию, false в противном случае.
Since:: 1.5, DOM Level 3

lookupNamespaceURI

String lookupNamespaceURI(String prefix)

Ищет URI пространства имён, связанный с данным префиксом, начиная с этого узла.
См. для получения подробной информации об алгоритме, используемом этим методом.

Parameters:: prefix - Префикс для поиска. Если этот параметр равен null, метод вернёт URI пространства имён по умолчанию, если оно есть.
Returns:: Возвращает связанный URI пространства имён или null, если не найден.
Since:: 1.5, DOM Level 3

isEqualNode

boolean isEqualNode(Node arg)

Проверяет, равны ли два узла.
Этот метод проверяет равенство узлов, а не тождество (т.е., ссылаются ли два узла на один и тот же объект), что можно проверить с помощью Node.isSameNode(). Все узлы, которые одинаковы, также будут равны, хотя обратное может быть неверным.
Два узла равны тогда и только тогда, когда выполнены следующие условия:

Два узла имеют одинаковый тип.
Следующие строковые атрибуты равны: nodeName, localName, namespaceURI, prefix, nodeValue. Это: они оба null, или они имеют одинаковую длину и являются символами за символом идентичными.
Атрибуты attributes NamedNodeMaps равны. Это: они оба null, или они имеют одинаковую длину, и для каждого узла, который существует в одной карте, существует узел, который существует в другой карте и равен ему, хотя и не обязательно на том же индексе.
Атрибуты childNodes NodeLists равны. Это: они оба null, или они имеют одинаковую длину и содержат равные узлы на тех же индексах. Обратите внимание, что нормализация может повлиять на равенство; для избежания этого узлы должны быть нормализованы перед сравнением.

Для того, чтобы два DocumentType узла были равны, также должны быть выполнены следующие условия:

Следующие строковые атрибуты равны: publicId, systemId, internalSubset.
Атрибуты entities NamedNodeMaps равны.
Атрибуты notations NamedNodeMaps равны.

С другой стороны, следующие факторы не влияют на равенство: атрибуты ownerDocument, baseURI и parentNode, атрибут specified для Attr узлов, атрибут schemaTypeInfo для Attr и Element узлов, атрибут Text.isElementContentWhitespace для Text узлов, а также любые пользовательские данные или обработчики событий, зарегистрированные в узлах.

Примечание: Как общее правило, всё, что не упомянуто в описании выше, не имеет значения при проверке равенства. Обратите внимание, что будущие версии этого спецификации могут учитывать больше атрибутов, и ожидается, что реализации, соответствующие этой спецификации, будут обновлены соответственно.

Parameters:: arg - Узел для сравнения на равенство.
Returns:: Возвращает true, если узлы равны, false в противном случае.
Since:: 1.5, DOM Level 3

getFeature

Object getFeature(String feature, String version)

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

Parameters:: feature - Имя запрошенного функционального блока. Обратите внимание, что любой знак "+" перед именем функционального блока будет проигнорирован, поскольку он не имеет значения в контексте этого метода.; version - Номер версии функционального блока для проверки.
Returns:: Возвращает объект, который реализует специализированные API указанного функционального блока и версии, если таковой имеется, или null, если нет объекта, который реализует интерфейсы, связанные с этим функциональным блоком. Если DOMObject, возвращённый этим методом, реализует интерфейс Node, он должен делегировать первичному ядру Node и не возвращать результаты, несовместимые с первичным ядром Node, такие как атрибуты, childNodes и т. д.
Since:: 1.5, DOM Level 3

setUserData

Object setUserData(String key, Object data, UserDataHandler handler)

Связывает объект с ключом в этом узле. Объект можно позже извлечь из этого узла, вызвав getUserData с тем же ключом.

Parameters:: key - Ключ, к которому нужно привязать объект.; data - Объект, который нужно привязать к заданному ключу, или null, чтобы удалить любые существующие ассоциации с этим ключом.; handler - Обработчик, который нужно связать с этим ключом, или null.
Returns:: Возвращает DOMUserData, ранее связанный с заданным ключом в этом узле, или null, если его не было.
Since:: 1.5, DOM Level 3

getUserData

Object getUserData(String key)

Извлекает объект, связанный с ключом в этом узле. Объект должен быть сначала задан этому узлу с помощью вызова setUserData с тем же ключом.

Parameters:: key - Ключ, к которому привязан объект.
Returns:: Возвращает DOMUserData, связанный с заданным ключом в этом узле, или null, если его не было.
Since:: 1.5, DOM Level 3

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/Node.html