Range.cloneContents()

The Range.cloneContents() returns a DocumentFragment copying the objects of type Node included in the Range.

Event Listeners added using DOM Events are not copied during cloning. HTML attribute events are duplicated as they are for the DOM Core cloneNode method. HTML id attributes are also cloned, which can lead to an invalid document through cloning.

Partially selected nodes include the parent tags necessary to make the document fragment valid.

Syntax

documentFragment = range.cloneContents();

Example

range = document.createRange();
range.selectNode(document.getElementsByTagName("div").item(0));
documentFragment = range.cloneContents();
document.body.appendChild(documentFragment);

Specifications

Specification Status Comment
DOM
The definition of 'Range.cloneContents()' in that specification.
Living Standard No change.
Document Object Model (DOM) Level 2 Traversal and Range Specification
The definition of 'Range.cloneContents()' in that specification.
Recommendation Initial specification.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.0 (1.7 or earlier) 9.0 9.0 (Yes)
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) 9.0 9.0 (Yes)

See also

Document Tags and Contributors

Tags: 
Contributors to this page: teoli, fscholz, afreen, shubham.hatwar, Sheppy, SkyLined, Gor1
Last updated by: teoli,