HighlightRegistry: forEach() 方法

基準線 2025
新推出

自 2025 年 6 月起,此功能已在最新的裝置和瀏覽器版本中可用。此功能可能不適用於舊裝置或瀏覽器。

HighlightRegistry 介面的 forEach() 方法對登錄檔中的每個 Highlight 物件按插入順序執行一次提供的函式。

HighlightRegistry 是一個類似 Map 的物件,因此這與使用 Map.forEach() 類似。

語法

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

引數

回撥

對每個 Highlight 物件執行的函式,接受三個引數

highlight

當前的 highlight。

name

highlight 名稱。

registry

呼叫 forEach() 的登錄檔物件。

thisArg

執行 callbackFn 時用作 this 的值。

返回值

無(undefined)。

示例

以下程式碼片段演示瞭如何建立一個具有兩個範圍的新 highlight,然後使用 forEach() 方法記錄這些範圍

js
function logAllHighlights(highlight, name) {
  console.log(`Highlight ${name} exists in the registry`, highlight);
}

const customHighlight1 = new Highlight();
const customHighlight2 = new Highlight();
const customHighlight3 = new Highlight();

CSS.highlights.set("custom-highlight-1", customHighlight1);
CSS.highlights.set("custom-highlight-2", customHighlight2);
CSS.highlights.set("custom-highlight-3", customHighlight3);

CSS.highlights.forEach(logAllHighlights);

規範

規範
ECMAScript® 2026 語言規範
# sec-map.prototype.foreach

瀏覽器相容性

另見