W3cubDocs

/Web APIs

StaticRange: StaticRange() constructor

The StaticRange() constructor creates a new StaticRange object representing a span of content within the DOM.

This constructor 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

js

new StaticRange(rangeSpec)

Parameters

rangeSpec

The required rangeSpec parameter is an object containing the four following properties:

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 the startContainer and/or endContainer are a type of node which you can't include in a range. Those node types are Node.DOCUMENT_TYPE_NODE (representing the DocumentType node derived from the DTD identified using the doctype preamble in the HTML, for example) and the Attr node describing an attribute of an element on the DOM.

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

© 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/StaticRange