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 typeof InputEvent.prototype.getTargetRanges === "function";
}
Basic usage
The following example selects a contenteditable
element and utilises 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 2The definition of 'getTargetRanges()' in that specification. | Working Draft | Initial definition. |
Browser Compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 60 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 47 |
Safari
Full support 10.1 |
WebView Android
Full support 60 |
Chrome Android
Full support 60 |
Firefox Android
No support No |
Opera Android
Full support 44 |
Safari iOS
Full support 10.3 |
Samsung Internet Android
Full support 8.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
InputEvent.getTargetRanges() by Mozilla Contributors is licensed under CC-BY-SA 2.5.