CompositionEvent: data property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.

The data read-only property of the CompositionEvent interface returns the characters generated by the input method that raised the event; its exact nature varies depending on the type of event that generated the CompositionEvent object.

Value

A string representing the event data:

  • For compositionstart events, this is the currently selected text that will be replaced by the string being composed. This value doesn't change even if content changes the selection range; rather, it indicates the string that was selected when composition started.
  • For compositionupdate, this is the string as it stands currently as editing is ongoing.
  • For compositionend events, this is the string as committed to the editor.

Specifications

Specification
UI Events
# dom-compositionevent-data

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
data

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also