The Selection.getRangeAt()
method returns a range object representing one of the ranges currently selected.
On this page
Selection: getRangeAt() method
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
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 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
See also
Selection
, the interface it belongs to.
© 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/Selection/getRangeAt