XMLSerializer: метод serializeToString()
Базовая поддержка Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Метод XMLSerializer serializeToString() создаёт строку, представляющую указанное дерево DOM в формате XML.
Синтаксис
serializeToString(rootNode)
Параметры
Возвращаемое значение
Строка, содержащая XML-представление указанного дерева DOM.
Исключения
TypeError-
Выбрасывается, если указанный
rootNodeне является совместимым типом узла. Корневой узел должен быть либоNode, либоAttr. -
InvalidStateErrorDOMException -
Выбрасывается, если дерево не удалось сериализовать, вероятно, из-за проблем с совместимостью содержимого с сериализацией XML.
-
SyntaxErrorDOMException -
Выбрасывается, если была запрошена сериализация HTML, но не удалось успешно завершить её из-за того, что содержимое не является хорошо сформированным.
Примечания по использованию
Совместимые типы узлов
Указанный корневой узел — и все его потомки — должны быть совместимы с алгоритмом сериализации XML. Сам корневой узел должен быть объектом типа Node или Attr.
Следующие типы также разрешены в качестве потомков корневого узла, помимо Node и Attr:
Если обнаруживается любой другой тип, выбрасывается исключение TypeError.
Примечания по результатам XML
Есть несколько моментов, на которые стоит обратить внимание в отношении XML-выхода метода serializeToString():
- Для XML-сериализации узлы
ElementиAttrвсегда сериализуются с ихnamespaceURIбез изменений. Это может означать, что ранее указанныйprefixили по умолчанию пространство имён может быть опущено или изменено. - Полученный XML совместим с HTML-парсером.
- Элементы в пространстве имён HTML, у которых нет дочерних узлов (тем самым представляющих пустые теги), сериализуются с начальными и конечными тегами (
"<someelement></someelement>") вместо использования тега пустого элемента ("<someelement/>").
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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