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

瀏覽器相容性

另見