HighlightRegistry: forEach() 方法

基准线 2025

新推出

自 2025 年 6 月起，此功能已在最新的设备和浏览器版本中可用。此功能可能不适用于旧设备或浏览器。

HighlightRegistry 接口的 forEach() 方法对注册表中的每个 Highlight 对象按插入顺序执行一次提供的函数。

HighlightRegistry 是一个类似 Map 的对象，因此这与使用 Map.forEach() 类似。

语法

forEach(callbackFn)
forEach(callbackFn, thisArg)

参数

回调

对每个 Highlight 对象执行的函数，接受三个参数

highlight: 当前的 highlight。
name: highlight 名称。
registry: 调用 forEach() 的注册表对象。

thisArg

执行 callbackFn 时用作 this 的值。

返回值

无（undefined）。

示例

以下代码片段演示了如何创建一个具有两个范围的新 highlight，然后使用 forEach() 方法记录这些范围

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

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后更新于 ⁨2025 年 6 月 23 日⁩，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的问题