W3cubDocs

/Web APIs

StaticRange

The DOM StaticRange interface extends AbstractRange to provide a method to specify a range of content in the DOM whose contents don't update to reflect changes which occur within the DOM tree.

This interface offers the same set of properties and methods as AbstractRange.

AbstractRange and StaticRange are not available from web workers.

AbstractRange StaticRange

Constructor

StaticRange()

Creates a new StaticRange object given the StaticRangeInit dictionary specifying the default values for its properties.

Instance properties

The properties below are inherited from its parent interface, AbstractRange.

StaticRange.collapsed Read only

Returns a Boolean value which is true if the range's start and end positions are the same, resulting in a range of length 0.

StaticRange.endContainer Read only

Returns the DOM Node which contains the ending point of the range. The offset into the node at which the end position is located is indicated by endOffset.

StaticRange.endOffset Read only

Returns an integer value indicating the offset into the node given by endContainer at which the last character of the range is found.

StaticRange.startContainer Read only

Returns the DOM Node which contains the starting point of the range (which is in turn identified by startOffset.

StaticRange.startOffset Read only

Returns an integer value indicating the offset into the node specified by startContainer at which the first character of the range is located.

Usage notes

A DOM range specifies a span of content in a document, potentially beginning inside one node (or element) and ending inside another one. Unlike a Range, a StaticRange represents a range which is fixed in time; it does not change to try to keep the same content within it as the document changes. If any changes are made to the DOM, the actual data contained within the range specified by a StaticRange may change. This lets the user agent avoid a lot of work that is unnecessary if the web app or site doesn't need a live-updating range.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
StaticRange 90 90 71 No 76 13.1 90 90 79 64 13.4 15.0
StaticRange 60 18
69In Firefox, StaticRange can currently only be used by browser-internal code or code with enhanced permissions; it is not yet exposed to the web.
No 47 10.1 60 60 79 44 10.3 8.0
collapsed 60 18 69 No 47 10.1 60 60 79 44 10.3 8.0
endContainer 60 18 69 No 47 10.1 60 60 79 44 10.3 8.0
endOffset 60 18 69 No 47 10.1 60 60 79 44 10.3 8.0
startContainer 60 18 69 No 47 10.1 60 60 79 44 10.3 8.0
startOffset 60 18 69 No 47 10.1 60 60 79 44 10.3 8.0

See also

  • Live updating range of content within the DOM: Range
  • AbstractRange, the abstract interface from which all ranges are derived

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/StaticRange