Selection.getRangeAt()
Experimental
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
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.
Example
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 | Status | Comment |
---|---|---|
Selection API The definition of 'Selection: getRangeAt()' in that specification. |
Working Draft | Current |
Browser compatibility
BCD tables only load in the browser
See also
Selection
, the interface it belongs to.- Tree Selection (for the
getRangeAt()
method on thensITreeSelection
interface)