Back to Content

DOMParser

files/en-us/web/api/domparser/index.md

latest1.8 KB
Original Source

{{APIRef("DOM")}}

The DOMParser interface provides the ability to parse {{Glossary("XML")}} or {{Glossary("HTML")}} source code from a string into a DOM {{domxref("Document")}}.

You can perform the opposite operation—converting a DOM tree into XML or HTML source—using the {{domxref("XMLSerializer")}} interface.

In the case of an HTML document, you can also replace portions of the DOM with new DOM trees built from HTML by setting the value of the {{domxref("Element.innerHTML")}} and {{domxref("Element.outerHTML", "outerHTML")}} properties. These properties can also be read to fetch HTML fragments corresponding to the corresponding DOM subtree.

Note that {{domxref("XMLHttpRequest")}} can parse XML and HTML directly from a URL-addressable resource, returning a Document in its {{domxref("XMLHttpRequest.response", "response")}} property.

[!NOTE] Be aware that block-level elements like <p> will be automatically closed if another block-level element is nested inside and therefore parsed before the closing </p> tag.

Constructor

  • {{domxref("DOMParser.DOMParser","DOMParser()")}}
    • : Creates a new DOMParser object.

Instance methods

  • {{domxref("DOMParser.parseFromString()")}}
    • : Parses an input {{domxref("TrustedHTML")}} instance or string as HTML or XML and returns a {{domxref("Document")}}.

Examples

The documentation for {{domxref("DOMParser.parseFromString()")}}, this interface's only method, contains examples for parsing XML, SVG, and HTML strings.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • Parsing and serializing XML
  • {{domxref("XMLHttpRequest")}}
  • {{domxref("XMLSerializer")}}
  • {{jsxref("JSON.parse()")}} - counterpart for {{jsxref("JSON")}} documents.