StaticRange.StaticRange()

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 the StaticRangeInit dictionary. The four required rangeSpec 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 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

Specification Status Comment
DOM
The definition of 'StaticRange()' in that specification.
Living Standard Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
StaticRange() constructorChrome No support NoEdge No support NoFirefox Full support 71IE No support NoOpera No support NoSafari Full support 13.1WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS Full support 13.4Samsung Internet Android No support No

Legend

Full support
Full support
No support
No support