dom / latest / selection / getrangeat.html /

Selection.getRangeAt()

The Selection.getRangeAt() method returns a range object representing one of the ranges currently selected.

Syntax

getRangeAt(index)

Parameters

index

The zero-based index of the range to return. A negative number or a number greater than or equal to Selection.rangeCount will result in an error.

Return value

The specified Range object.

Examples

let ranges = [];

sel = window.getSelection();

for(let i = 0; i < sel.rangeCount; i++) {
 ranges[i] = sel.getRangeAt(i);
}
/* Each item in the ranges array is now
 * a range object representing one of the
 * ranges in the current selection */

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
getRangeAt
1
12
1
9
≤12.1
3
1
18
4
≤12.1
1
1.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Selection/getRangeAt