大网数据广告活动
Web 标准与前端开发

XMLSerializer: serializeToString() method

· 52CE 我爱测

The XMLSerializer method **`serializeToString()`** constructs a string representing the specified DOM tree in XML form.

HTML DOM

The XMLSerializer method serializeToString() constructs a string representing the specified DOM tree in XML form.

Syntax

serializeToString(rootNode)

Parameters

  • rootNode
    • : The Node to use as the root of the DOM tree or subtree for which to construct an XML representation.

Return value

A string containing the XML representation of the specified DOM tree.

Exceptions

  • TypeError
    • : Thrown if the specified rootNode is not a compatible node type. The root node must be either Node or Attr.
  • InvalidStateError DOMException
    • : Thrown if the tree could not be successfully serialized, probably due to issues with the content's compatibility with XML serialization.
  • SyntaxError DOMException
    • : Thrown if a serialization of HTML was requested but could not succeed due to the content not being well-formed.

Usage notes

Compatible node types

The specified root node—and all of its descendants—must be compatible with the XML serialization algorithm. The root node itself must be either a Node or Attr object.

The following types are also permitted as descendants of the root node, in addition to Node and Attr:

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

If any other type is encountered, a TypeError exception is thrown.

Notes on the resulting XML

There are some things worth noting about the XML output by serializeToString():

  • For XML serializations, Element and Attr nodes are always serialized with their Element.namespaceURI intact. This may mean that a previously-specified Element.prefix or default namespace may be dropped or altered.
  • The resulting XML is compatible with the HTML parser.
  • Elements in the HTML namespace that have no child nodes (thereby representing empty tags) are serialized with both begin and end tags ("<someelement></someelement>") instead of using the empty-element tag ("<someelement/>").

Specifications

Browser compatibility

See also

  • Parsing and serializing XML
  • Serializing to HTML: Element.innerHTML and Element.outerHTML
  • Parsing HTML or XML to create a DOM tree: DOMParser

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。