--- title: XMLSerializer slug: Web/API/XMLSerializer tags: - DOM Parsing - XML - XMLSerializer - construct - conversion translation_of: Web/API/XMLSerializer original_slug: XMLSerializer --- <div dir="ltr" style="text-align: left;">{{APIRef("XMLSerializer")}}</div> <div dir="ltr" id="result_box" style="text-align: left;"><code>XMLSerializer</code>接口提供{{domxref("XMLSerializer.serializeToString", "serializeToString()")}} 方法来构建一个代表 {{Glossary("DOM")}} 树的XML字符串。</div> <h2 id="Methods" name="Methods">方法</h2> <dl> <dt id="serializeToString">{{domxref("XMLSerializer.serializeToString", "serializeToString()")}}</dt> <dd>返回DOM子树序列化后的字符串。</dd> <dt id="serializeToStream">{{domxref("XMLSerializer.serializeToStream", "serializeToStream()")}} {{ non-standard_inline }}{{ deprecated_inline }}</dt> <dd>将指定元素的每个子树按照特定的字符集序列化成字节流。</dd> </dl> <h2 id="Examples" name="Examples">示例</h2> <h3 id="把_XML_序列化为字符串">把 XML 序列化为字符串</h3> <p>首先,最基本的例子是将整个 document 对象序列化为一个 XML 字符串。</p> <pre class="brush: js"> var s = new XMLSerializer(); var d = document; var str = s.serializeToString(d); saveXML(str);</pre> <p>这里新建了一个 <code>XMLSerializer</code> 对象实例, 然后将待序列化的 {{domxref("Document")}} 对象实例传入返回等价 XML 的 {{domxref("XMLSerializer.serializeToString", "serializeToString()")}} 方法。</p> <h3 id="向一个基于_XML_的_DOM_对象中">向一个基于 XML 的 DOM 对象中</h3> <p>本例使用 {domxref("Element.insertAdjacentHTML()")}} 方法将一个新的 DOM {{domxref("Node")}} 插入 基于序列化 {{domxref("Document")}} 对象创建的 XML 中。</p> <div class="note"> <p><strong>注意:</strong> 在真实场景下,你通常应该通过调用 {{domxref("Document.importNode", "importNode()")}} 方法将新节点加入 DOM 中, 然后通过调用以下方法将目标节点添加到 DOM 树:</p> <ul> <li>{{domxref("Document")}} 和 {{domxref("Element")}} 方法 {{domxref("ParentNode.append", "append()")}} 和 {{domxref("ParentNode.prepend", "prepend()")}}</li> <li>{{domxref("ChildNode.replaceWith", "Node.replaceWith()")}} 方法(替换现有节点)</li> <li>{{domxref("Document.insertAdjacentElement()")}} 和 {{domxref("Element.insertAdjacentElement()")}} 方法.</li> </ul> </div> <p>因为<code>insertAdjacentHTML()</code> 的第二个参数是一个字符串而不是 <code>Node</code> 节点对象, 所以这里先要使用 <code>XMLSerializer</code> 将节点转换为字符串.</p> <pre class="brush: js">var inp = document.createElement('input'); var XMLS = new XMLSerializer(); var inp_xmls = XMLS.serializeToString(inp); // 先将一个 DOM 节点转换为字符串。 // 将新建的节点添加到 DOM 中。 document.body.insertAdjacentHTML('afterbegin', inp_xmls);</pre> <p>以上代码通过调用 {{domxref("Document.createElement()")}} 方法新建一个 {HTMLElement("input")}} 对象 , 然后通过 {{domxref("XMLSerializer.serializeToString", "serializeToString()")}} 方法将该对象序列化为 XML.</p> <p>做完以上工作之后, 使用 <code>insertAdjacentHTML()</code> 方法将 <code><input></code> 元素加入 DOM.</p> <h2 id="规范">规范</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">Specification</th> <th scope="col">Status</th> <th scope="col">Comment</th> </tr> <tr> <td>{{SpecName('DOM Parsing', '#the-xmlserializer-interface', 'XMLSerializer')}}</td> <td>{{Spec2('DOM Parsing')}}</td> <td></td> </tr> </tbody> </table> <h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2> <div>{{Compat("api.XMLSerializer")}}</div> <h2 id="参见">参见</h2> <ul> <li><a href="https://developer.mozilla.org/en-US/Parsing_and_serializing_XML" title="en-US/Parsing_and_serializing_XML">Parsing and serializing XML</a></li> <li>{{domxref("XMLHttpRequest")}}</li> <li>{{domxref("DOMParser")}}</li> </ul>