Selection: removeRange() method

Baseline 2023
Newly available

Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The Selection.removeRange() method removes a range from a selection.

Syntax

js
removeRange(range)

Parameters

range

A range object that will be removed from the selection.

Return value

None (undefined).

Examples

js
/* Programmatically, more than one range can be selected.
 * This will remove all ranges except the first. */
const s = window.getSelection();
if (s.rangeCount > 1) {
  for (let i = 1; i < s.rangeCount; i++) {
    s.removeRange(s.getRangeAt(i));
  }
}

Specifications

Specification
Selection API
# dom-selection-removerange

Browser compatibility

See also