This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The Selection.getRangeAt() method returns a range object representing one of the ranges currently selected.
Syntax
range = sel.getRangeAt(index)
Parameters
range- The
Rangeobject that will be returned. index- The zero-based index of the range to return. A negative number or a number greater than or equal to
Selection.rangeCountwill result in an error.
Examples
var ranges = [];
sel = window.getSelection();
for(var 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 | Status | Comment |
|---|---|---|
| HTML Editing APIs The definition of 'Selection.getRangeAt()' in that specification. |
Editor's Draft | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | Yes | (Yes) | (Yes) | ? | ? | ? |
| Feature | Android | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | (Yes) | 1.0 | ? | ? | ? |
See also
Selection, the interface it belongs to.- Tree Selection (for the
getRangeAt()method on thensITreeSelectioninterface)
Document Tags and Contributors
Tags:
Contributors to this page:
abbycar,
Dan-Dascalescu,
fscholz,
teoli,
jsx,
kscarfone,
chitra_lakhotia,
Sheppy,
ethertank,
Brettz9,
DR,
Diablownik,
Jonnyq
Last updated by:
abbycar,