Интерфейс 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`

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

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

Modifier and Type	Field	Description
`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` узлом.

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

Modifier and Type	Method	Description
`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 содержащая нулевые узлы.

getFirstChild

Node getFirstChild()

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

getLastChild

Node getLastChild()

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

getPreviousSibling

Node getPreviousSibling()

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

getNextSibling

Node getNextSibling()

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

getAttributes

NamedNodeMap getAttributes()

Коллекция, содержащая атрибуты этого узла (если это 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 заменяется всеми DocumentFragment дочерними элементами, которые вставляются в том же порядке. Если 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, операция нормализации сама по себе может быть недостаточной, поскольку 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()

Указатель на пространство имён этого узла или null , если он не указан (см. ).
Это не вычисленное значение, которое является результатом поиска пространства имён, основанного на проверке объявлений пространств имён в области видимости. Это просто URI пространства имён, заданный во время создания.
Для узлов любого типа, кроме ELEMENT_NODE и ATTRIBUTE_NODE, и узлов, созданных методом DOM Level 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 Level 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 Level 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 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

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

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, 2021, 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/17/docs/api/java.xml/org/w3c/dom/Node.html