Web/API/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
DOMThe 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.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
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

StaticRange.StaticRange() by Mozilla Contributors is licensed under CC-BY-SA 2.5.