InputEvent.getTargetRanges()

The getTargetRanges() method of the InputEvent interface returns an array of static ranges that will be affected by a change to the DOM if the input event is not canceled.

Syntax

var staticRanges[] = inputEvent.getTargetRanges()

Parameters

None.

Return value

An array of StaticRange objects.

Examples

Feature Detection

The following function returns true if beforeinput, and thus getTargetRanges, is supported.

function isBeforeInputEventAvailable() {
  return window.InputEvent && typeof InputEvent.prototype.getTargetRanges === "function";
}

Basic usage

The following example selects a contenteditable element and utilizes the beforeinput event to log the result of getTargetRanges().

const editableElem = document.querySelector('[contenteditable="true"]');

editableElem.addEventListener('beforeinput', (e) => {
    const targetRanges = e.getTargetRanges();
    console.log(targetRanges);
})

Specifications

Specification Status Comment
Input Events Level 2
The definition of 'getTargetRanges()' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser