JavaScript: The Definitive Guide, Fourth Edition

Name

Range.extractContents( ) — delete document content and return it in a DocumentFragment

Availability

DOM Level 2 Range

Synopsis

DocumentFragment extractContents(  )    
    throws DOMException;

Returns

A DocumentFragment node that contains the contents of this range.

Throws

This method throws a DOMException with a code of NO_MODIFICATION_ALLOWED_ERR if any part of the document content to be extracted is read-only, or a code of HIERARCHY_REQUEST_ERR if the range contains a DocumentType node.

Description

This method deletes the specified range of a document and returns a DocumentFragment node that contains the deleted content (or a copy of the deleted content). When this method returns, the range is collapsed, and the document may contain adjacent Text nodes (which can be merged with Node.normalize( )).

See Also

DocumentFragment, Range.cloneContents( ), Range.deleteContents( )