The KeyboardEvent() constructor creates a new KeyboardEvent.
Syntax
event = new KeyboardEvent(typeArg, KeyboardEventInit);
Values
- typeArg
- Is a
DOMStringrepresenting the name of the event. - KeyboardEventInitOptional
- Is a
KeyboardEventInitdictionary, having the following fields:"key", optional and defaulting to"", of typeDOMString, that sets the value ofKeyboardEvent.key."code", optional and defaulting to"", of typeDOMString, that sets the value ofKeyboardEvent.code."location", optional and defaulting to0, of typeunsigned long, that sets the value ofKeyboardEvent.location."ctrlKey", optional and defaulting tofalse, of typeBoolean, that sets the value ofKeyboardEvent.ctrlKey."shiftKey", optional and defaulting tofalse, of typeBoolean, that sets the value ofKeyboardEvent.shiftKey."altKey", optional and defaulting tofalse, of typeBoolean, that sets the value ofKeyboardEvent.altKey."metaKey", optional and defaulting tofalse, of typeBoolean, that sets the value ofKeyboardEvent.metaKey."repeat", optional and defaulting tofalse, of typeBoolean, that sets the value ofKeyboardEvent.repeat."isComposing", optional and defaulting tofalse, of typeBoolean, that sets the value ofKeyboardEvent.isComposing."charCode", optional and defaulting to0, of typeunsigned long, that sets the value of the deprecatedKeyboardEvent.charCode."keyCode", optional and defaulting to0, of typeunsigned long, that sets the value of the deprecatedKeyboardEvent.keyCode."which", optional and defaulting to0, of typeunsigned long, that sets the value of the deprecatedKeyboardEvent.which.
The
KeyboardEventInitdictionary also accepts fields from theUIEventInitandEventInitdictionaries.
Specifications
| Specification | Status | Comment |
|---|---|---|
| UI Events The definition of 'KeyboardEvent()' in that specification. |
Working Draft | Current definition. |
| Document Object Model (DOM) Level 3 Events Specification The definition of 'KeyboardEvent()' in that specification. |
Obsolete | 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.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
KeyboardEvent() constructor | Chrome Full support Yes | Edge Full support ≤79 | Firefox Full support 31 | IE No support No | Opera Full support Yes | Safari ? | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 31 | Opera Android Full support Yes | Safari iOS ? | Samsung Internet Android Full support Yes |
Added code and key to KeyboardEventInit | Chrome Full support 49 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera ? | Safari ? | WebView Android Full support 49 | Chrome Android Full support 49 | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
See also
KeyboardEvent, the interface of the objects it constructs.
