Интерфейс 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 — это основной тип данных для всего Document Object Model. Он представляет собой узел в дереве документа. Хотя все объекты, реализующие интерфейс Node, предоставляют методы для работы с дочерними элементами, не все объекты, реализующие интерфейс Node, могут иметь дочерние элементы. Например, узлы Text могут не иметь дочерних элементов, а добавление дочерних элементов к таким узлам приводит к возникновению исключения DOMException.

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

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

Таблица интерфейсов
Интерфейс	nodeName	nodeValue	attributes
`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`

См. также Спецификацию Document Object Model (DOM) Level 3 Core.

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

Модификатор и тип	Поле	Описание
`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()

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

getOwnerDocument

Document getOwnerDocument()

Объект Document, связанный с этим узлом. Это также объект Document, используемый для создания новых узлов. Когда этот узел является 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 является объектом DocumentFragment, все его дочерние узлы вставляются в том же порядке перед 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 является объектом DocumentFragment, 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 - Узел для добавления. Если это объект DocumentFragment, все содержимое фрагмента документа перемещается в список дочерних узлов этого узла.
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, клонирует только сам узел (и его атрибуты, если это Element).
Returns:: Дубликат узла.

normalize

void normalize()

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

Примечание: В случаях, когда документ содержит CDATASections, одной операции нормализации может быть недостаточно, так как XPointers не различают узлы 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 уровня 1, например, Document.createElement(), это всегда null.

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

Since:: 1.4, DOM Level 2

getPrefix

String getPrefix()

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

Since:: 1.4, DOM Level 2

setPrefix

void setPrefix(String prefix) throws DOMException

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

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

getLocalName

String getLocalName()

Возвращает локальную часть полного имени этого узла.
Для узлов любого типа, кроме ELEMENT_NODE и ATTRIBUTE_NODE, и узлов, созданных методом DOM уровня 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

setTextContent

void setTextContent(String textContent) throws DOMException

Таблица узел/содержимое
Тип узла	Содержимое
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 на любой из ссылок всегда имеет точно такой же эффект.

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

lookupPrefix

String lookupPrefix(String namespaceURI)

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

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

isDefaultNamespace

boolean isDefaultNamespace(String namespaceURI)

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

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

lookupNamespaceURI

String lookupNamespaceURI(String prefix)

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

Параметры:: prefix - Префикс, который ищется. Если этот параметр равен null, метод вернет URI пространства имен по умолчанию, если оно существует.
Возвращает:: Возвращает связанный URI пространства имен или null , если он не найден.
С:: 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 узлов, а также любые пользовательские данные или обработчики событий, зарегистрированные на узлах.

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

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

getFeature

Object getFeature(String feature, String version)

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

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

setUserData

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

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

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

getUserData

Object getUserData(String key)

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

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

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.xml/org/w3c/dom/Node.html