Selection: getRangeAt() method

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

Syntax

js
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

js
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

Specification
Selection API
# dom-selection-getrangeat

Browser compatibility

BCD tables only load in the browser

See also