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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic support
Experimental
Chrome Full support YesEdge Full support YesFirefox Full support YesIE ? Opera ? Safari ? WebView Android ? Chrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

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,