The StaticRange()
constructor creates a new StaticRange
object representing a span of content within the DOM. It includes properties identifying the standard and end positions of the range as well as a Boolean indicating whether or not the range is collapsed (that is, empty).
Syntax
var staticRange = new StaticRange(rangeSpec)
Parameters
rangeSpec
-
The required
rangeSpec
parameter is an object adhering to theStaticRangeInit
dictionary. The four requiredrangeSpec
properties are:startContainer
- The
Node
in 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
Node
in which the end point of the range is located. endOffset
- The offset into the node indicated by
endOffset
at 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
DOMException
fired if either or both of thestartContainer
and/orendContainer
are a type of node which you can't include in a range. Those node types areNode.DOCUMENT_TYPE_NODE
(representing theDocumentType
node derived from the DTD identified using thedoctype
preamble in the HTML, for example) and theAttr
node describing an attribute of an element on the DOM..
Specifications
Specification | Status | Comment |
---|---|---|
DOM The definition of 'StaticRange()' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
StaticRange() constructor | Chrome No support No | Edge No support No | Firefox Full support 71 | IE No support No | Opera No support No | Safari Full support 13.1 | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS Full support 13.4 | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support