Spec-Zone.ru › Web APIs

XMLSerializer: метод serializeToString()

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Метод XMLSerializer serializeToString() создаёт строку, представляющую указанное дерево DOM в формате XML.

Синтаксис

serializeToString(rootNode)

Параметры

rootNode

Узел Node, используемый в качестве корня дерева DOM или поддерева, для которого необходимо создать представление в формате XML.

Возвращаемое значение

Строка, содержащая XML-представление указанного дерева DOM.

Исключения

TypeError

Выбрасывается, если указанный rootNode не является совместимым типом узла. Корневой узел должен быть либо Node, либо Attr.

InvalidStateError DOMException

Выбрасывается, если дерево не удалось сериализовать, вероятно, из-за проблем с совместимостью содержимого с сериализацией XML.

SyntaxError DOMException

Выбрасывается, если была запрошена сериализация HTML, но не удалось успешно завершить её из-за того, что содержимое не является хорошо сформированным.

Примечания по использованию

Совместимые типы узлов

Указанный корневой узел — и все его потомки — должны быть совместимы с алгоритмом сериализации XML. Сам корневой узел должен быть объектом типа Node или Attr.

Следующие типы также разрешены в качестве потомков корневого узла, помимо Node и Attr:

  • DocumentType
  • Document
  • DocumentFragment
  • Element
  • Comment
  • Text
  • ProcessingInstruction
  • Attr

Если обнаруживается любой другой тип, выбрасывается исключение TypeError.

Примечания по результатам XML

Есть несколько моментов, на которые стоит обратить внимание в отношении XML-выхода метода serializeToString():

  • Для XML-сериализации узлы Element и Attr всегда сериализуются с их namespaceURI без изменений. Это может означать, что ранее указанный prefix или по умолчанию пространство имён может быть опущено или изменено.
  • Полученный XML совместим с HTML-парсером.
  • Элементы в пространстве имён HTML, у которых нет дочерних узлов (тем самым представляющих пустые теги), сериализуются с начальными и конечными тегами ("<someelement></someelement>") вместо использования тега пустого элемента ("<someelement/>").

Спецификации

Спецификация
DOM Parsing and Serialization
# dom-xmlserializer-serializetostring

Совместимость с браузерами

Рабочие столы Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
serializeToString 1 12 1 ≤12.1 3 18 4 ≤12.1 1 1.0 4.4

См. также

  • Парсинг и сериализация XML
  • Сериализация в HTML: Element.innerHTML и Element.outerHTML
  • Парсинг HTML или XML для создания дерева DOM: DOMParser

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XMLSerializer/serializeToString

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API