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