Документация интерфейса

public interface Document
extends Node

Интерфейс Document представляет собой весь документ HTML или XML. Концептуально, это корень дерева документа и предоставляет основной доступ к данным документа.

Поскольку элементы, текстовые узлы, комментарии, инструкции обработки и т. д. не могут существовать вне контекста Document, интерфейс Document также содержит методы-фабрики, необходимые для создания этих объектов. Объекты Node, созданные с помощью этих методов, имеют атрибут ownerDocument, который связывает их с Document в контексте которого они были созданы.

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

Методы

getDoctype

DocumentType getDoctype()

Декларация типа документа (см. DocumentType) , связанная с этим документом. Для XML-документов без декларации типа документа возвращается null. Для HTML-документов может возвращаться объект DocumentType, независимо от наличия или отсутствия декларации типа документа в HTML-документе.
Это обеспечивает прямой доступ к узлу DocumentType, дочернему узлу этого Document. Этот узел можно задать во время создания документа и позже изменить с помощью методов манипулирования дочерними узлами, таких как Node.insertBefore, или Node.replaceChild. Однако, хотя некоторые реализации могут создавать объекты разных типов Document с дополнительными функциями, помимо "Основных", такими как "HTML" [DOM Level 2 HTML], на основе DocumentType , заданного во время создания, изменение его впоследствии вряд ли приведёт к изменению поддерживаемых функций.

Since:

DOM Level 3

getImplementation

DOMImplementation getImplementation()

Объект DOMImplementation, который обрабатывает этот документ. Приложение DOM может использовать объекты из нескольких реализаций.

getDocumentElement

Element getDocumentElement()

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

createElement

Element createElement(String tagName)
               throws DOMException

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

Parameters:

tagName - Имя типа элемента для создания экземпляра. Для XML это чувствительно к регистру, в противном случае это зависит от чувствительности к регистру используемого языка разметки. В этом случае имя отображается в канонической форме этой разметки реализацией DOM.

Returns:

Новый объект Element с атрибутом nodeName , установленным в tagName, и атрибутами localName, prefix, и namespaceURI установленных в null.

Throws:

DOMException - INVALID_CHARACTER_ERR: Вызывается, если указанное имя не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.

createDocumentFragment

DocumentFragment createDocumentFragment()

Создаёт пустой объект DocumentFragment.

Returns:

Новый DocumentFragment.

createTextNode

Text createTextNode(String data)

Создаёт узел Text с заданной строкой.

Parameters:

data - Данные для узла.

Returns:

Новый объект Text.

createComment

Comment createComment(String data)

Создаёт узел Comment с заданной строкой.

Parameters:

data - Данные для узла.

Returns:

Новый объект Comment.

createCDATASection

CDATASection createCDATASection(String data)
                         throws DOMException

Создаёт узел CDATASection со значением заданной строки.

Parameters:

data - Данные для содержимого CDATASection.

Returns:

Новый объект CDATASection.

Throws:

DOMException - NOT_SUPPORTED_ERR: Вызывается, если этот документ является HTML-документом.

createProcessingInstruction

ProcessingInstruction createProcessingInstruction(String target,
                                                  String data)
                                           throws DOMException

Создаёт узел ProcessingInstruction с заданными именем и данными.

Parameters:

target - Целевая часть инструкции обработки.В отличие от Document.createElementNS или Document.createAttributeNS, проверка корректности пространства имён для целевого имени не выполняется. Приложения должны вызывать Document.normalizeDocument() с параметром "namespaces", установленным в true, чтобы гарантировать корректность целевого имени в пространстве имён.

data - Данные для узла.

Returns:

Новый объект ProcessingInstruction.

Throws:

DOMException - INVALID_CHARACTER_ERR: Вызывается, если указанное имя не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion .
NOT_SUPPORTED_ERR: Вызывается, если этот документ является HTML-документом.

createAttribute

Attr createAttribute(String name)
              throws DOMException

Создаёт Attr с заданным именем. Обратите внимание, что экземпляр Attr может быть затем установлен на Element с помощью метода setAttributeNode.
Для создания атрибута с квалифицированным именем и URI пространства имён используйте метод createAttributeNS.

Parameters:

name - Имя атрибута.

Returns:

Новый объект Attr с атрибутом nodeName , установленным в name, и атрибутами localName, prefix, и namespaceURI установленных в null . Значение атрибута - пустая строка.

Throws:

DOMException - INVALID_CHARACTER_ERR: Вызывается, если указанное имя не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.

createEntityReference

EntityReference createEntityReference(String name)
                               throws DOMException

Parameters:

name - Имя сущности для ссылки. В отличие от Document.createElementNS или Document.createAttributeNS, проверка корректности имени сущности в пространстве имён не выполняется. Приложения должны вызывать Document.normalizeDocument() с параметром "namespaces", установленным в true, чтобы гарантировать корректность имени сущности в пространстве имён.

Returns:

Новый объект EntityReference.

Throws:

DOMException - INVALID_CHARACTER_ERR: Вызывается, если указанное имя не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion .
NOT_SUPPORTED_ERR: Вызывается, если этот документ является HTML-документом.

getElementsByTagName

NodeList getElementsByTagName(String tagname)

Возвращает коллекцию NodeList всех Elements в порядке документа с заданным именем тега, содержащихся в документе.

Parameters:

tagname - Имя тега для сопоставления. Специальное значение "*" соответствует всем тегам. Для XML параметр tagname чувствителен к регистру, в противном случае это зависит от чувствительности к регистру используемого языка разметки.

Returns:

Новый объект NodeList , содержащий все соответствующие Elements.

importNode

Node importNode(Node importedNode,
                boolean deep)
         throws DOMException

Импортирует узел из другого документа в этот документ, без изменения или удаления исходного узла из исходного документа; этот метод создаёт новую копию исходного узла. Возвращаемый узел не имеет родителя; (parentNode это null).
Для всех узлов импорт узла создаёт объект узла, принадлежащий импортирующему документу, с атрибутами, идентичными nodeName и nodeType исходного узла, плюс атрибуты, связанные с пространствами имён (prefix, localName, и namespaceURI). Как и в операции cloneNode, исходный узел не изменяется. Данные пользователя, связанные с импортированным узлом, не переносятся. Однако, если были указаны какие-либо UserDataHandlers, вместе с соответствующими данными, эти обработчики будут вызваны с соответствующими параметрами перед возвратом этого метода.
Дополнительная информация копируется соответствующим образом в nodeType, пытаясь отразить поведение, ожидаемое при копировании фрагмента исходного XML или HTML из одного документа в другой, учитывая, что в случае XML два документа могут иметь разные DTD. В списке ниже описаны особенности для каждого типа узла.

ATTRIBUTE_NODE

Атрибут ownerElement устанавливается в null, а флаг specified устанавливается в true для сгенерированного Attr. Потомки исходного Attr импортируются рекурсивно, а результирующие узлы собираются для формирования соответствующего поддерева. Обратите внимание, что параметр deep не влияет на узлы Attr; они всегда переносят свои дочерние элементы при импорте.

DOCUMENT_FRAGMENT_NODE

Если параметр deep был установлен в true, потомки исходного DocumentFragment импортируются рекурсивно, а результирующие узлы собираются под импортированным DocumentFragment для формирования соответствующего поддерева. В противном случае, это просто генерирует пустой Document.

DOCUMENT_NODE

Document узлы не могут быть импортированы.

DOCUMENT_TYPE_NODE

DocumentType узлы не могут быть импортированы.

ELEMENT_NODE

Узлы атрибутов, указанные в исходном элементе, импортируются, и сгенерированные Attr узлы присоединяются к сгенерированному Element элементу. Значения атрибутов по умолчанию не копируются, хотя если импортируемый документ определяет значения атрибутов по умолчанию для этого имени элемента, они будут назначены. Если параметр importNode deep был установлен в true, потомки исходного элемента импортируются рекурсивно, и результирующие узлы собираются для формирования соответствующего поддерева.

ENTITY_NODE

Entity узлы могут быть импортированы, однако в текущей версии DOM атрибут DocumentType является только для чтения. Возможность добавления этих импортированных узлов в DocumentType будет рассмотрена для добавления в будущие версии DOM. При импорте атрибуты publicId, systemId, и notationName копируются. Если запрашивается импорт deep, потомки исходного Entity импортируются рекурсивно, и результирующие узлы собираются для формирования соответствующего поддерева.

ENTITY_REFERENCE_NODE

Копируется только сам EntityReference, даже если запрашивается импорт deep, поскольку исходные и целевые документы могут определить сущность по-разному. Если импортируемый документ предоставляет определение для этого имени сущности, его значение присваивается.

NOTATION_NODE

Notation узлы могут быть импортированы, однако в текущей версии DOM атрибут DocumentType является только для чтения. Возможность добавления этих импортированных узлов в DocumentType будет рассмотрена для добавления в будущие версии DOM. При импорте атрибуты publicId и systemId копируются. Обратите внимание, что параметр deep не влияет на этот тип узлов, так как они не могут иметь дочерних элементов.

PROCESSING_INSTRUCTION_NODE

Импортированный узел копирует значения target и data из исходного узла. Обратите внимание, что параметр deep не влияет на этот тип узлов, так как они не могут иметь дочерних элементов.

TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE

Эти три типа узлов, наследуемых от CharacterData, копируют атрибуты data и length из исходного узла. Обратите внимание, что параметр deep не влияет на эти типы узлов, так как они не могут иметь дочерних элементов.

Параметры:

importedNode - Узел для импорта.

deep - Если true, рекурсивно импортировать поддерево под указанным узлом; если false, импортировать только сам узел, как описано выше. Это не влияет на узлы, которые не могут иметь дочерних элементов, и на узлы Attr и EntityReference.

Возвращает:

Импортированный узел, принадлежащий этому Document.

Исключения:

DOMException - NOT_SUPPORTED_ERR: Выбрасывается, если тип импортируемого узла не поддерживается.
INVALID_CHARACTER_ERR: Выбрасывается, если одно из импортированных имён не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion Например, это может произойти при импорте XML 1.1 [XML 1.1] элемента в документ XML 1.0.

С:

DOM Level 2

createElementNS

Element createElementNS(String namespaceURI,
                        String qualifiedName)
                 throws DOMException

Создаёт элемент с заданным полным именем и URI пространства имён.
В соответствии с [XML Namespaces] приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они хотят не использовать пространство имён.

Параметры:

namespaceURI - URI пространства имён создаваемого элемента.

qualifiedName - Полное имя типа элемента, который необходимо создать.

Возвращает:

Новый объект Element с следующими атрибутами:

Атрибут	Значение
Node.nodeName	qualifiedName
Node.namespaceURI	namespaceURI
Node.prefix	Префикс, извлечённый из qualifiedName, или null если префикса нет
Node.localName	Локальное имя, извлечённое из qualifiedName
Element.tagName	qualifiedName

Исключения:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если указанный qualifiedName не является именем XML в соответствии с версией XML, используемой в атрибуте Document.xmlVersion.
NAMESPACE_ERR: Выбрасывается, если qualifiedName является некорректно сформированным полным именем, если у qualifiedName есть префикс и namespaceURI равно null, или если у qualifiedName есть префикс "xml" и namespaceURI отличается от " http://www.w3.org/XML/1998/namespace" [XML Namespaces] , или если у qualifiedName или его префикс равно "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/", или если namespaceURI равно "http://www.w3.org/2000/xmlns/" и ни у qualifiedName ни у его префикса не равно "xmlns".
NOT_SUPPORTED_ERR: Всегда выбрасывается, если текущий документ не поддерживает функцию "XML", так как пространства имён были определены в XML.

С:

DOM Level 2

createAttributeNS

Attr createAttributeNS(String namespaceURI,
                       String qualifiedName)
                throws DOMException

Создаёт атрибут с заданным полным именем и URI пространства имён.
В соответствии с [XML Namespaces] приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они не хотят использовать пространство имён.

Параметры:

namespaceURI - URI пространства имён атрибута, который нужно создать.

qualifiedName - Квалифицированное имя атрибута, который нужно создать.

Возвращает:

Новый объект Attr со следующими атрибутами:

Атрибут	Значение
Node.nodeName	qualifiedName
Node.namespaceURI	namespaceURI
Node.prefix	префикс, извлечённый из qualifiedName, или null если префикса нет
Node.localName	локальное имя, извлечённое из qualifiedName
Attr.name	qualifiedName
Node.nodeValue	пустая строка

Выбрасывает:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если указанное qualifiedName не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.
NAMESPACE_ERR: Выбрасывается, если qualifiedName имеет неправильный формат квалифицированного имени, если у qualifiedName есть префикс и namespaceURI равно null, если у qualifiedName есть префикс "xml" и namespaceURI отличается от " http://www.w3.org/XML/1998/namespace", если qualifiedName или его префикс равен "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/", или если namespaceURI равно "http://www.w3.org/2000/xmlns/" и ни qualifiedName ни его префикс не равны "xmlns".
NOT_SUPPORTED_ERR: Всегда выбрасывается, если текущий документ не поддерживает функциональность "XML", так как пространства имён были определены в XML.

С тех пор:

DOM Level 2

getElementsByTagNameNS

NodeList getElementsByTagNameNS(String namespaceURI,
                                String localName)

Возвращает список всех элементов с заданным локальным именем и URI пространства имён в порядке следования в документе.

Параметры:

namespaceURI - URI пространства имён элементов, которые нужно найти. Специальное значение "*" соответствует всем пространствам имён.

localName - Локальное имя элементов, которые нужно найти. Специальное значение "*" соответствует всем локальным именам.

Возвращает:

Новый список элементов, содержащий все совпадающие элементы.

С тех пор:

DOM Level 2

getElementById

Element getElementById(String elementId)

Параметры:

elementId - Уникальное значение id элемента.

Возвращает:

Соответствующий элемент или null, если такового нет.

С тех пор:

DOM Level 2

getInputEncoding

String getInputEncoding()

Атрибут, определяющий кодировку, используемую для данного документа во время разбора. Возвращает null, если кодировка неизвестна, например, когда документ создан в памяти.

С тех пор:

DOM Level 3

getXmlEncoding

String getXmlEncoding()

Атрибут, определяющий кодировку документа, как часть декларации XML. Возвращает null, если кодировка не указана или неизвестна, например, когда документ создан в памяти.

С тех пор:

DOM Level 3

getXmlStandalone

boolean getXmlStandalone()

С тех пор:

DOM Level 3

setXmlStandalone

void setXmlStandalone(boolean xmlStandalone)
               throws DOMException

Выбрасывает:

DOMException - NOT_SUPPORTED_ERR: Выбрасывается, если этот документ не поддерживает функциональность "XML".

С тех пор:

DOM Level 3

getXmlVersion

String getXmlVersion()

Атрибут, определяющий версию документа, как часть декларации XML. Если декларация отсутствует и документ поддерживает функциональность "XML", значение равно "1.0". Если документ не поддерживает функциональность "XML", значение всегда равно null. Изменение этого атрибута повлияет на методы, проверяющие некорректные символы в именах XML. Приложение должно вызвать Document.normalizeDocument() для проверки некорректных символов в Node которые уже присутствуют в этом Document.
Приложения DOM могут использовать метод DOMImplementation.hasFeature(feature, version) с параметрами "XMLVersion" и "1.0" (соответственно) для определения, поддерживает ли реализация [XML 1.0]. Приложения DOM могут использовать тот же метод с параметрами "XMLVersion" и "1.1" для определения, поддерживает ли реализация [XML 1.1]. В обоих случаях для поддержки XML реализация также должна поддерживать функциональность "XML", определённую в данном спецификации. Объекты Document поддерживающие версию функциональности "XMLVersion", не должны генерировать исключение NOT_SUPPORTED_ERR для того же номера версии при использовании Document.xmlVersion.

С тех пор:

DOM Level 3

setXmlVersion

void setXmlVersion(String xmlVersion)
            throws DOMException

Атрибут, определяющий версию документа, как часть декларации XML. Если декларация отсутствует и документ поддерживает функциональность "XML", значение равно "1.0". Если документ не поддерживает функциональность "XML", значение всегда равно null. Изменение этого атрибута повлияет на методы, проверяющие некорректные символы в именах XML. Приложение должно вызвать Document.normalizeDocument() для проверки некорректных символов в Node которые уже присутствуют в этом Document.
Приложения DOM могут использовать метод DOMImplementation.hasFeature(feature, version) с параметрами "XMLVersion" и "1.0" (соответственно) для определения, поддерживает ли реализация [XML 1.0]. Приложения DOM могут использовать тот же метод с параметрами "XMLVersion" и "1.1" для определения, поддерживает ли реализация [XML 1.1]. В обоих случаях для поддержки XML реализация также должна поддерживать функциональность "XML", определённую в данном спецификации. Объекты Document поддерживающие версию функциональности "XMLVersion", не должны генерировать исключение NOT_SUPPORTED_ERR для того же номера версии при использовании Document.xmlVersion.

Выбрасывает:

DOMException - NOT_SUPPORTED_ERR: Выбрасывается, если версия установлена на значение, которое не поддерживается этим Document или если этот документ не поддерживает функциональность "XML".

С тех пор:

DOM Level 3

getStrictErrorChecking

boolean getStrictErrorChecking()

Атрибут, определяющий, включена ли жёсткая проверка ошибок. Если установлено значение true, реализация может не проверять все возможные случаи ошибок, обычно определённые для операций DOM, и не генерировать исключения DOMException при выполнении операций DOM или при сообщении об ошибках во время использования Document.normalizeDocument(). В случае ошибки поведение не определено. По умолчанию этот атрибут равен false.

С тех пор:

DOM Level 3

setStrictErrorChecking

void setStrictErrorChecking(boolean strictErrorChecking)

Атрибут, определяющий, включена ли жёсткая проверка ошибок. Если установлено значение true, реализация может не проверять все возможные случаи ошибок, обычно определённые для операций DOM, и не генерировать исключения DOMException при выполнении операций DOM или при сообщении об ошибках во время использования Document.normalizeDocument(). В случае ошибки поведение не определено. По умолчанию этот атрибут равен false.

С тех пор:

DOM Level 3

getDocumentURI

String getDocumentURI()

Расположение документа или null, если не определено или если Document создан с помощью DOMImplementation.createDocument. При установке этого атрибута лексическая проверка не выполняется; это может привести к возвращению значения null при использовании Node.baseURI.
Обратите внимание, что когда Document поддерживает функциональность "HTML" [DOM Level 2 HTML] , атрибут href элемента HTML BASE имеет приоритет над этим атрибутом при вычислении Node.baseURI.

С тех пор:

DOM Level 3

УстановитьURLДокумента

void setDocumentURI(String documentURI)

Расположение документа или null если оно не определено или если Document было создано с использованием DOMImplementation.createDocument. При установке этого атрибута лексическая проверка не выполняется; это может привести к возврату значения null при использовании Node.baseURI .
Обратите внимание, что когда Document поддерживает функцию «HTML» [DOM Level 2 HTML], атрибут href элемента HTML BASE имеет приоритет над этим атрибутом при вычислении Node.baseURI.

С тех пор:

DOM Level 3

ПринятьУзел

Node adoptNode(Node source)
        throws DOMException

Параметры:

source - Узел для перемещения в этот документ.

Возвращает:

Принятый узел или null если операция завершается неудачно, например, когда исходный узел из другого модуля.

Выбрасывает:

DOMException - NOT_SUPPORTED_ERR: Вызывается, если исходный узел типа DOCUMENT, DOCUMENT_TYPE.
NO_MODIFICATION_ALLOWED_ERR: Вызывается, когда исходный узел только для чтения.

С тех пор:

DOM Level 3

ПолучитьКонфигурациюDOM

DOMConfiguration getDomConfig()

Конфигурация, используемая при вызове Document.normalizeDocument().

С тех пор:

DOM Level 3

НормализоватьДокумент

void normalizeDocument()

Этот метод действует так, как если бы документ проходил цикл сохранения и загрузки, приводя документ в «нормальную» форму. Вследствие этого этот метод обновляет дерево замены узлов EntityReference и нормализует узлы Text, как определено в методе Node.normalize().
В противном случае фактический результат зависит от настроек, заданных в объекте Document.domConfig и управляющих выполняемыми операциями. Заметно, что этот метод также может сделать пространство имён документа хорошо сформированным в соответствии с алгоритмом, описанным в, проверить нормализацию символов, удалить узлы CDATASection и т.д. Подробнее см. DOMConfiguration.

// Keep in the document
 the information defined // in the XML Information Set (Java example)
 DOMConfiguration docConfig = myDocument.getDomConfig();
 docConfig.setParameter("infoset", Boolean.TRUE);
 myDocument.normalizeDocument();

При поддержке генерируются события мутации, отражающие происходящие изменения в документе.
Если во время вызова этого метода возникнут ошибки, такие как попытка обновить узел только для чтения или узел Node.nodeName содержит недопустимый символ в соответствии с используемой версией XML, ошибки или предупреждения (DOMError.SEVERITY_ERROR или DOMError.SEVERITY_WARNING) будут сообщены с использованием объекта DOMErrorHandler , связанного с параметром «обработчик ошибок». Обратите внимание, что этот метод также может сообщать об ошибках критического уровня (DOMError.SEVERITY_FATAL_ERROR) , если реализация не может восстановиться от ошибки.

С тех пор:

DOM Level 3

ПереименоватьУзел

Node renameNode(Node n,
                String namespaceURI,
                String qualifiedName)
         throws DOMException

Переименовать существующий узел типа ELEMENT_NODE или ATTRIBUTE_NODE.
Если это возможно, просто изменяет имя заданного узла, в противном случае создаёт новый узел с указанным именем и заменяет существующий узел новым узлом, как описано ниже.
Если простое изменение имени заданного узла невозможно, выполняются следующие операции: создаётся новый узел, любой зарегистрированный обработчик событий регистрируется на новом узле, любые данные пользователя, прикреплённые к старому узлу, удаляются с этого узла, старый узел удаляется из своего родителя, если он есть, дочерние элементы перемещаются в новый узел, если переименовываемый узел является Element , его атрибуты перемещаются в новый узел, новый узел вставляется в позицию, которую занимал старый узел в списке дочерних узлов своего родителя, если он есть, данные пользователя, прикреплённые к старому узлу, прикрепляются к новому узлу.
Если переименовываемый узел является Element , перемещаются только указанные атрибуты, значения атрибутов по умолчанию, полученные из DTD, обновляются в соответствии с новым именем элемента. Кроме того, реализация может обновить атрибуты по умолчанию из других схем. Приложения должны использовать Document.normalizeDocument() для гарантии актуальности этих атрибутов.
Если переименовываемый узел является Attr , который прикреплён к Element, узел сначала удаляется из карты атрибутов Element. Затем, после переименования, будь то путём изменения существующего узла или создания нового, как описано выше, он возвращается обратно.
Кроме того,

• генерируется событие данных пользователя NODE_RENAMED ,
• при поддержке функции "MutationNameEvents" каждая операция мутации, участвующая в этом методе, генерирует соответствующее событие, и в конце генерируется событие { http://www.w3.org/2001/xml-events, DOMElementNameChanged} или { http://www.w3.org/2001/xml-events, DOMAttributeNameChanged}.

Параметры:

n - Узел для переименования.

namespaceURI - Новый URI пространства имён.

qualifiedName - Новое полное имя.

Возвращает:

Переименованный узел. Это либо указанный узел, либо новый узел, созданный для замены указанного узла.

Выбрасывает:

DOMException - NOT_SUPPORTED_ERR: Вызывается, если тип указанного узла не ELEMENT_NODE и не ATTRIBUTE_NODE, или если реализация не поддерживает переименование элемента документа.
INVALID_CHARACTER_ERR: Вызывается, если новое полное имя не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.
WRONG_DOCUMENT_ERR: Вызывается, когда указанный узел был создан из другого документа, чем этот документ.
NAMESPACE_ERR: Вызывается, если qualifiedName является неправильно сформированным полным именем, если qualifiedName имеет префикс и namespaceURI равно null, или если qualifiedName имеет префикс "xml" и namespaceURI отличается от " http://www.w3.org/XML/1998/namespace" [XML Namespaces] . Также вызывается, когда переименовываемый узел является атрибутом, если qualifiedName, или его префикс, равен "xmlns", и namespaceURI отличается от "http://www.w3.org/2000/xmlns/".

С тех пор:

DOM Level 3