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 GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
data |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
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.