W3cubDocs

/Web APIs

KeyboardLayoutMap

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

The KeyboardLayoutMap interface of the Keyboard API is a read-only object with functions for retrieving the string associated with specific physical keys.

A KeyboardLayoutMap instance is a read-only Map-like object, in which each key is a string identifying the unique physical key on the keyboard (a "key code"), and the corresponding value is the associated key attribute value (which may be affected by the keyboard layout, and so on).

A list of valid keys is found in the UI Events KeyboardEvent code Values specification.

Instance properties

KeyboardLayoutMap.entries Read only Experimental

Returns an array of a given object's own enumerable property [key, value] pairs, in the same order as that provided by a for...in loop (the difference being that a for-in loop enumerates properties in the prototype chain as well).

KeyboardLayoutMap.keys Read only Experimental

Returns a new array iterator object that contains the keys for each index in the array.

KeyboardLayoutMap.size Read only Experimental

Returns the number of elements in the KeyboardLayoutMap object.

KeyboardLayoutMap.values Read only Experimental

Returns a new array iterator object that contains the values for each index in the KeyboardLayoutMap object.

Instance methods

KeyboardLayoutMap.forEach() Read only Experimental

Executes a provided function once for each element of KeyboardLayoutMap.

KeyboardLayoutMap.get() Experimental

Returns the element with the given key from the KeyboardLayoutMap object.

KeyboardLayoutMap.has() Experimental

Returns a boolean indicating whether the KeyboardLayoutMap object has an element with the specified key.

Examples

The following example demonstrates how to get the location- or layout-specific string associated with the key that corresponds to the 'W' key on an English QWERTY keyboard.

js

const keyboard = navigator.keyboard;
keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  const upKey = keyboardLayoutMap.get("KeyW");
  window.alert(`Press ${upKey} to move up.`);
});

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
@@iterator 69 79 No No 56 No 69 69 No 48 No 10.0
KeyboardLayoutMap 69 79 No No 55 No 69 69 No 48 No 10.0
entries 69 79 No No 56 No 69 69 No 48 No 10.0
forEach 69 79 No No 56 No 69 69 No 48 No 10.0
get 69 79 No No 56 No 69 69 No 48 No 10.0
has 69 79 No No 56 No 69 69 No 48 No 10.0
keys 69 79 No No 56 No 69 69 No 48 No 10.0
size 69 79 No No 56 No 69 69 No 48 No 10.0
values 69 79 No No 56 No 69 69 No 48 No 10.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/KeyboardLayoutMap