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

Узел является Attr.

static short CDATA_SECTION_NODE

Узел является CDATASection.

static short COMMENT_NODE

Узел является Comment.

static short DOCUMENT_FRAGMENT_NODE

Узел является DocumentFragment.

static short DOCUMENT_NODE

Узел является Document.

static short DOCUMENT_POSITION_CONTAINED_BY

Узел находится внутри узла-ссылки.
static short DOCUMENT_POSITION_CONTAINS

Узел содержит узел-ссылку.
static short DOCUMENT_POSITION_DISCONNECTED

Два узла не соединены.
static short DOCUMENT_POSITION_FOLLOWING

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

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

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

Узел является DocumentType.

static short ELEMENT_NODE

Узел является Element.

static short ENTITY_NODE

Узел является Entity.

static short ENTITY_REFERENCE_NODE

Узел является EntityReference.

static short NOTATION_NODE

Узел является Notation.

static short PROCESSING_INSTRUCTION_NODE

Узел является ProcessingInstruction.

static short TEXT_NODE

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

Методы

Модификатор и тип Метод Описание
Node appendChild​(Node newChild)

Добавляет узел newChild в конец списка дочерних узлов этого узла.
Node cloneNode​(boolean deep)

Возвращает дубликат этого узла, то есть служит универсальным конструктором копирования для узлов.
short compareDocumentPosition​(Node other)

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

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

Абсолютный базовый URI этого узла или null, если реализация не смогла получить абсолютный URI.
NodeList getChildNodes()

Объект, содержащий все дочерние узлы этого узла.
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

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

Исключения:
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 - Вставляемый узел.
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 и результат операции замены добавит второй узел DocumentType или Element в узел Document.
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, включая узлы атрибутов, к "нормальной" форме, где только структура (например, элементы, комментарии, инструкции обработки, секции CDATA и ссылки на сущности) отделяет Text узлы, т.е. нет ни смежных 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 Namespaces] атрибут не наследует своё пространство имён от элемента, к которому он присоединён. Если атрибуту явно не задано пространство имён, у него просто нет пространства имён.

С:
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

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

Исключения:
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 Namespaces] .
С:
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 элемента HTML BASE, если он есть, и значение атрибута 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). Аналогично, при установке не выполняется ни один парсинг, входная строка рассматривается как чисто текстовое содержимое.
Возвращаемая строка формируется из текстового содержимого этого узла в зависимости от его типа, как определено ниже:

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

Этот атрибут возвращает текстовое содержимое этого узла и его потомков. Когда он определен как 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

Возбуждает:
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, 2020, 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/11/docs/api/java.xml/org/w3c/dom/Node.html

Spec-Zone .ru
спецификации, руководства, описания, API