The KeyboardEvent.metaKey read-only property returning a Boolean that indicates if the Meta key was pressed (true) or not (false) when the event occurred. Some operating systems may intercept the key so it is never detected.
Note: On Macintosh keyboards, this is the ⌘ Command key. On Windows keyboards, this is the Windows key (⊞ Windows).
At least as of Firefox 48, the (⊞ Windows) key is not considered the "Meta" key. KeyboardEvent.metaKey is false when the (⊞ Windows is pressed.
Syntax
var metaKeyPressed = instanceOfKeyboardEvent.metaKey
Return value
A boolean
Example
function ismetaKey(e) {
alert("metaKey = " + e.metaKey);
}
<button onclick="ismetaKey(event)">Click me with the meta key</button>
Specifications
| Specification | Status | Comment |
|---|---|---|
| Document Object Model (DOM) Level 3 Events Specification The definition of 'KeyboardEvent.metaKey' in that specification. |
Working Draft | Initial definition |
Browser compatibility
| Feature | Firefox (Gecko) | Chrome | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
| Feature | Firefox Mobile (Gecko) | Android | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | ? | ? | ? | ? | ? |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
NicholasBoll,
Makyen,
stan3,
cvrebert,
empirreamm,
Sebastianz,
fscholz,
teoli
Last updated by:
NicholasBoll,