XMLSerializer：serializeToString() 方法

基线 广泛可用

此功能已得到很好的建立，并且可以在许多设备和浏览器版本上运行。自以下时间以来，它已在浏览器中可用 2015 年 7 月.

该 XMLSerializer 方法 serializeToString() 构造一个字符串，该字符串以 XML 形式表示指定的 DOM 树。

语法

js
serializeToString(rootNode)

参数

rootNode

要作为 DOM 树或子树的根节点使用的 Node，以便为其构建 XML 表示形式。

返回值

包含指定 DOM 树的 XML 表示形式的字符串。

异常

TypeError

如果指定的 rootNode 不是兼容的节点类型，则抛出。根节点必须是 Node 或 Attr。

InvalidStateError DOMException

如果树无法成功序列化，则抛出，这可能是由于内容与 XML 序列化兼容性方面存在问题。

SyntaxError DOMException

如果请求了 HTML 的序列化但由于内容格式不正确而无法成功，则抛出。

使用说明

兼容的节点类型

指定的根节点及其所有后代必须与 XML 序列化算法兼容。根节点本身必须是 Node 或 Attr 对象。

除了 Node 和 Attr 之外，以下类型也允许作为根节点的后代

如果遇到任何其他类型，则会抛出 TypeError 异常。

关于结果 XML 的说明

关于 serializeToString() 输出的 XML，有一些值得注意的事情

  • 对于 XML 序列化，Element 和 Attr 节点始终使用其 namespaceURI 进行序列化。这可能意味着先前指定的 prefix 或默认命名空间可能会被删除或更改。
  • 生成的 XML 与 HTML 解析器兼容。
  • HTML 命名空间中没有子节点的元素（因此表示空标签）使用开始和结束标签（"<someelement></someelement>"）进行序列化，而不是使用空元素标签（"<someelement/>"）。

规范

规范
DOM 解析和序列化
# dom-xmlserializer-serializetostring

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅