DOMParser

From MDC

DOMParser can be used to parse strings and streams of XML text. It can't be used to parse HTML "tag soup". DOMParser is available to unprivileged scripts.

[edit] DOMParser changes in Firefox 3

• When a DOMParser is instantiated by calling new DOMParser(), it inherits the calling code's principal and the documentURI and baseURI of the window the constructor came from.
• If the caller has UniversalXPConnect privileges, it can pass parameters to new DOMParser(). If fewer than three parameters are passed, the remaining parameters will default to null.
  • The first parameter is the principal to use; this overrides the default principal normally inherited.
  • The second parameter is the documentURI to use.
  • The third parameter is the baseURI to use.
• If you instantiate a DOMParser by calling createInstance(), and you don't call the DOMParser's init() method, attempting to initiate a parsing operation will automatically call init() on the DOMParser with a null principal and null pointers for documentURI and baseURI.

[edit] Error handling

Note that if the parsing process failed, DOMParser currently does not throw an exception, but instead returns an error document (see bug 45566):

<parsererror xmlns="http://www.mozilla.org/newlayout/xml/parsererror.xml">
(error description)
<sourcetext>(a snipper of the source XML)</sourcetext>
</parsererror>

[edit] Example

var parser = new DOMParser();
var doc = parser.parseFromString(aStr, "text/xml");

[edit] See also

• Reference (XULPlanet)
• Parsing and serializing XML
• Parsing and serializing XML (XULPlanet)
• XMLHttpRequest
• XMLSerializer