Name
Range.extractContents( ): delete document content and return it in a DocumentFragment â 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.
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( )
Get JavaScript: The Definitive Guide, 5th Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.