KeyboardLayoutMap: forEach() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

KeyboardLayoutMap 接口的 forEach() 方法会为地图的每个元素执行一次提供的函数。

该方法与 Map.prototype.forEach() 方法相同。

语法

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

参数

callbackFn

要为每个元素执行的函数,接受三个参数

currentValue

正在处理的当前元素的值。

index 可选

正在处理的当前元素的索引。

array 可选

调用 forEach() 的 KeyboardLayoutMap。

thisArg 可选

执行 callback 时用作 this(即引用 Object)的值。

返回值

无(undefined)。

示例

下面的示例会遍历英文 QWERTY 键盘上的每个位置或布局特定的字符串及其关联的键盘代码。

js
navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  keyboardLayoutMap.forEach((key, code) => {
    console.log(`${code} keyboard code represents ${key} key`);
  });
});

规范

规范
ECMAScript® 2026 语言规范
# sec-map.prototype.foreach

浏览器兼容性

另见