createContextualFragment method

The createContextualFragment() method enables you to parse a string of HTML into a DocumentFragment using the starting node of a Document Object Model (DOM) Range as the parsing context. Unlike markup inserted into innerHTML, this method can be used to create pre-parsed content to be added or inserted into a document when needed later.

HTML5 A vocabulary and associated APIs for HTML and XHTMLInternet Explorer 10



var retVal = Range.createContextualFragment(fragment);


fragment [in]

Type: DOMString

String containing HTML to be parsed.

retVal [out, retval]

Type: DocumentFragment

A document fragment representing the parsed HTML.

Return value

Type: DocumentFragment

A document fragment representing the parsed HTML.



Throws this exception if the range has been detached. Versions earlier than Internet Explorer 10 will throw the exception as INVALID_STATE_ERR.


Standards information


When inserting elements into a DOM structure, some elements behave according to their context. Using createContextualFragment, you can ensure the parsed HTML will work as expected when inserted or added to the document.

Using this method in Windows Store apps using JavaScript

When you use this method in a Windows Store app using JavaScript, the fragment is filtered by the toStaticHTML method. For more info, see Making HTML safer: details for toStaticHTML.

See also