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

Начиная с:: 1.4, DOM уровня 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`, включая узлы-атрибуты, к «нормальной» форме, в которой узлы `Text` разделяются только структурными элементами (например, элементами, комментариями, инструкциями обработки, разделами CDATA и ссылками на сущности); то есть смежные узлы `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.

Начиная с:: 1.4, DOM Level 2

insertBefore

Node insertBefore(Node newChild, Node refChild) throws DOMException

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

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

Параметры:: newChild - Узел, который нужно вставить.; refChild - Опорный узел, то есть узел, перед которым необходимо вставить новый узел.
Возвращает:: Вставляемый узел.
Вызывает исключение:: 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.
Начиная с:: 1.4, DOM Level 3

replaceChild

Node replaceChild(Node newChild, Node oldChild) throws DOMException

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

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

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

removeChild

Node removeChild(Node oldChild) throws DOMException

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

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

appendChild

Node appendChild(Node newChild) throws DOMException

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

Параметры:: newChild - Узел, который нужно добавить.Если это объект DocumentFragment, все содержимое фрагмента документа перемещается в список дочерних узлов этого узла
Возвращает:: Добавленный узел.
Вызывает исключение:: 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.
Начиная с:: 1.4, DOM Level 3

hasChildNodes

boolean hasChildNodes()

Возвращает значение, указывающее, есть ли у этого узла дочерние узлы.

Возвращает:: Возвращает 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 зависит от реализации.

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

normalize

void normalize()

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

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

Начиная с:: 1.4, DOM Level 3

isSupported

boolean isSupported(String feature, String version)

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

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

getNamespaceURI

String getNamespaceURI()

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

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

Начиная с:: 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.

Начиная с:: 1.4, DOM Level 2

setPrefix

void setPrefix(String prefix) throws DOMException

Вызывает исключение:: 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].
Начиная с:: 1.4, DOM Level 2

getLocalName

String getLocalName()

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

Начиная с:: 1.4, DOM Level 2

hasAttributes

boolean hasAttributes()

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

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

getBaseURI

String getBaseURI()

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

Начиная с:: 1.5, DOM Level 3

compareDocumentPosition

short compareDocumentPosition(Node other) throws DOMException

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

Параметры:: other — узел для сравнения с узлом-ссылкой.
Возвращает:: Возвращает сведения о положении узла относительно узла-ссылки.
Вызывает исключение:: DOMException — NOT_SUPPORTED_ERR: если сравниваемые узлы принадлежат разным реализациям DOM, которые не взаимодействуют друг с другом для получения согласованных результатов, специфичных для реализации.
Начиная с версии:: 1.5, DOM Level 3

getTextContent

String getTextContent() throws DOMException

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

Node/Content table
Тип узла	Содержимое
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

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

setTextContent

void setTextContent(String textContent) throws DOMException

Node/Content table
Тип узла	Содержимое
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

Вызывает исключение:: DOMException — NO_MODIFICATION_ALLOWED_ERR: возникает, если узел доступен только для чтения.
Начиная с версии:: 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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/Node.html