This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The Selection.getRangeAt()
method returns a range object representing one of the ranges currently selected.
Syntax
range = sel.getRangeAt(index)
Parameters
range
- The
Range
object 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.rangeCount
will 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 thensITreeSelection
interface)
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,