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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes Yes Yes ? ? ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support ? Yes Yes Yes ? ? ?

See also

  • Selection, the interface it belongs to.
  • Tree Selection (for the getRangeAt() method on the nsITreeSelection interface)

Document Tags and Contributors

Last updated by: ddbeck,