Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
DOMParser HTML extension - Now a polyfill since HTML parsing was added to the DOMParser specification
* DOMParser HTML extension
* 2012-02-02
* By Eli Grey,
* Public domain.
/*global document, DOMParser*/
(function(DOMParser) {
"use strict";
DOMParser_proto = DOMParser.prototype
, real_parseFromString = DOMParser_proto.parseFromString
// Firefox/Opera/IE throw errors on unsupported types
try {
// WebKit returns null on unsupported types
if ((new DOMParser).parseFromString("", "text/html")) {
// text/html parsing is natively supported
} catch (ex) {}
DOMParser_proto.parseFromString = function(markup, type) {
if (/^\s*text\/html\s*(?:;|$)/i.test(type)) {
doc = document.implementation.createHTMLDocument("")
, doc_elt = doc.documentElement
, first_elt
doc_elt.innerHTML = markup;
first_elt = doc_elt.firstElementChild;
if ( // are we dealing with an entire document or a fragment?
doc_elt.childElementCount === 1
&& first_elt.localName.toLowerCase() === "html"
) {
doc.replaceChild(first_elt, doc_elt);
return doc;
} else {
return real_parseFromString.apply(this, arguments);

hsivonen commented Nov 1, 2011

This doesn't work correctly, it markup contains external scripts.


eligrey commented Nov 1, 2011

I cannot reproduce your problem. I used (new DOMParser).parseFromString("<script src='http://foo/bar.js'></script>", "text/html").querySelector("script").src === "http://foo/bar.js". Do you mean that the script isn't executed? DOMParser is for parsing HTML, not executing it. Create an iframe and manipulate its content document after appending into the current document if you wish to create an active document.

marijn commented Feb 3, 2012

@eligrey, how would this stack up to the html parser by @jeresig?


eligrey commented Feb 3, 2012

It will always be faster than @jeresig's parser as it uses the browser's native HTML5 parser.

marijn commented Feb 4, 2012


eligrey commented Feb 4, 2012

Every browser that supports document.implementation.createHTMLDocument should work. I think IE <8 might not support that. A workaround for IE <8 could be to use an iframe, but that creates an active document context, which is dangerous and should only be used for parsing trusted HTML.

In short, all current browsers support it.


eligrey commented Sep 4, 2012

Thanks for heads up @RobertXGreen; fixed.

igstan commented Sep 5, 2012

What's the reason you pass DOMParser as an argument to the anonymous function instead of just accessing it where you need it? Micro-optimization?

karger commented Oct 3, 2012

doesn't work in IE9 because innerHTML is a read-only property (line 36 fails).

karger commented Oct 5, 2012

Need to clarify my previous comment. You may be able to set doc.body.innerHTML, but that doesn't work if passed-in markup is an entire document ('....'). You might hope to fix this by setting innerHTML on doc.documentElement instead of doc.body, but IE (at least 9) doesn't let you do that.

This won't work correctly on document strings that contain a full document with a doctype, a head tag, a title tag, etc. Here's a gist based loosely on the suggestion from @karger to try out doc.documentElement instead:

I also made another gist that takes a more targeted approach to just making sure the title tag's content makes it into the new document irrespective of whatever else may be in the head. It's pretty hacky and I don't see how it would be all that useful to anyone, but here it is just in case anyone wants to look it over:

@eligrey, can you merge my changes from my first gist ( into your version?

Or if you don't think my changes are a good idea, let me know. Comments/feedback are totally welcome. Anywho, thanks for this polyfill. I wish more browsers had full support for DOMParser.


eligrey commented Apr 18, 2013

@kethinov I merged in your changes.

This is nice, but attributes on the documentElement will not be available in the DOMParser since this uses 'doc.documentElement.innerHTML' and the documentElement is read only in a DOM Implementation. So the attributes would need to be added manually. It's an edge case, but just adding a note for anyone that might run into that.

jslegers commented Dec 9, 2013

Since this polyfill assumes DOMParser is defined, you should add the following wrapper for your code :

if (window.DOMParser !== undefined){
    [   your code  ]

That way, your polyfill will just be ignored in browsers that don't support DOMParser (which happens to include IE8) instead of generating an error.

DrewML commented Mar 14, 2014

@jslegers: The code excerpt below is solving for that. You can't just do a check against the window for "DOMParser" because Safari supports DOMParser for XML, just not HTML. This can't be determined any other way besides using a try/catch.

try {
        // WebKit returns null on unsupported types
        if ((new DOMParser).parseFromString("", "text/html")) {
            // text/html parsing is natively supported
    } catch (ex) {}

@DrewML not trying to troll, but jslegers isn't talking about that at all, but the presence of DOMParser in the first place.

Only bothering to leave this as I had to read your comment and his a couple times before realizing what was going on.

(never even had to deal with DOMParser before this ridiculous bug that should be dealt with on the server side but isn't... but that's just me whinging)

Awesome, works for me on iOS pulling whole pages and parsing them with XMLHttpRequest :)

I add this code In my scripts files and works fine but this code run several times , How can i prevent this ? maybe some codes simlar below codes

DOMParserFlag = false;
if (DOMParserFlag == false) {

function DOMParser() {
    "use strict";


DOMParserFlag = true;


kube commented Nov 3, 2017

Setting .innerHTML will load image ressources (even if element is not appended to DOM), which is not the case with DOMParser.

gustavom commented Nov 8, 2017

I remove this

if (markup.toLowerCase().indexOf('<!doctype') > -1) {
        console.log('inserindo o elemento doc \n\n');
        //doc.documentElement.innerHTML = markup;
        doc.body.innerHTML = markup;
      } else {
        doc.body.innerHTML = markup;

and i changed for this

doc.body.innerHTML = markup;

and I got the result I needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment