StaticRange: StaticRange() constructor
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
The StaticRange() constructor
creates a new StaticRange object representing a span of content within
the DOM.
This constructor includes properties identifying the start and end positions of the range as well as a Boolean indicating whether or not the range is collapsed (that is, empty).
Syntax
new StaticRange(rangeSpec)
Parameters
rangeSpec-
The required
rangeSpecparameter is an object containing the four following properties:startContainer-
The
Nodein which the starting point of the range is located. startOffset-
The offset into the starting node at which the first character of the range is found.
endContainer-
The
Nodein which the end point of the range is located. endOffset-
The offset into the node indicated by
endOffsetat which the last character in the range is located.
Return value
A new StaticRange object initialized with the values given in
the rangeSpec object.
Exceptions
InvalidNodeTypeError-
A
DOMExceptionfired if either or both of thestartContainerand/orendContainerare a type of node which you can't include in a range. Those node types areNode.DOCUMENT_TYPE_NODE(representing theDocumentTypenode derived from the DTD identified using thedoctypepreamble in the HTML, for example) and theAttrnode describing an attribute of an element on the DOM.
Specifications
| Specification |
|---|
| DOM # ref-for-dom-staticrange-staticrange① |