InputEvent - Web APIs

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The InputEvent interface represents an event notifying of editable content change.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="/docs/Web/API/Event" target="_top"><rect x="1" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="38.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Event</text></a><polyline points="76,25  86,20  86,30  76,25" stroke="#D4DDE4" fill="none"/><line x1="86" y1="25" x2="116" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/UIEvent" target="_top"><rect x="116" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="153.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">UIEvent</text></a><polyline points="191,25  201,20  201,30  191,25" stroke="#D4DDE4" fill="none"/><line x1="201" y1="25" x2="231" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/InputEvent" target="_top"><rect x="231" y="1" width="100" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="281" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">InputEvent</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Constructor

InputEvent(): Creates an InputEvent object.

Properties

This interface inherits properties from its parents, UIEvent and Event.

InputEvent.dataRead only: Returns a DOMString with the inserted characters. This may be an empty string if the change doesn't insert text (such as when deleting characters, for example).
InputEvent.dataTransferRead only: Returns a DataTransfer object containing information about richtext or plaintext data being added to or removed from editable content.
InputEvent.inputTypeRead only: Returns the type of change for editable content such as, for example, inserting, deleting, or formatting text. See the property page for a complete list of input types.
InputEvent.isComposingRead only: Returns a Boolean value indicating if the event is fired after compositionstart and before compositionend.

Methods

This interface inherits methods from its parents, UIEvent and Event.

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

Specifications

Specification	Status	Comment
Input Events Level 2 The definition of 'InputEvent' in that specification.	Working Draft
UI Events The definition of 'InputEvent' in that specification.	Working Draft	Initial definition.

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`InputEvent` Experimental	Chrome Full support 60	Edge Full support 79	Firefox Full support 31	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 Full support 31	Opera Android Full support 44	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
`InputEvent()` constructor Experimental	Chrome Full support 60	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 47	Safari ?	WebView Android Full support 60	Chrome Android Full support 60	Firefox Android Full support 31	Opera Android Full support 44	Safari iOS ?	Samsung Internet Android Full support 8.0
`data` Experimental	Chrome Full support 60	Edge Full support 79	Firefox Full support 67	IE No support No	Opera Full support 47	Safari No support No	WebView Android Full support 60	Chrome Android Full support 60	Firefox Android Full support 67	Opera Android Full support 44	Safari iOS No support No	Samsung Internet Android Full support 8.0
`dataTransfer` Experimental	Chrome Full support 60	Edge Full support 79	Firefox Full support 67	IE No support No	Opera Full support 47	Safari No support No	WebView Android Full support 60	Chrome Android Full support 60	Firefox Android Full support 67	Opera Android Full support 44	Safari iOS No support No	Samsung Internet Android Full support 8.0
`getTargetRanges` Experimental	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
`inputType` Experimental	Chrome Full support 60	Edge Full support 79	Firefox Full support 66	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 Full support 66	Opera Android Full support 44	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
`isComposing` Experimental	Chrome Full support 60	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 47	Safari No support No	WebView Android Full support 60	Chrome Android Full support 60	Firefox Android Full support 31	Opera Android Full support 44	Safari iOS No support No	Samsung Internet Android Full support 8.0

Legend

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