Name
Range.detach( ) — free a Range object
Availability
DOM Level 2 Range
Synopsis
void detach( ) throws DOMException;
Throws
Like all Range methods, detach( )
throws a
DOMException with a code
of
INVALID_STATE_ERR
if it is called on a Range
object that has already been detached.
Description
DOM implementations keep track of all Range objects created for a
document, because they may need to change the range boundary points
when the document is modified. When you are certain that a Range
object isn’t needed any more, call the detach( )
method to tell the implementation that it no longer needs
to keep track of that range. Note that once this method has been
called for a Range object, any use of that Range will throw an
exception. Calling detach( )
is not required but
may improve performance in some circumstances when the document is
being modified and a Range object is not subject to immediate garbage
collection.
Get JavaScript: The Definitive Guide, Fourth 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.