HighlightRegistry：forEach() 方法

可用性有限

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

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

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

语法

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

参数

callback

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

highlight

当前高亮。

name

高亮名称。

registry

调用 forEach() 的注册表对象。

thisArg

在执行 callbackFn 时用作 this 的值。

返回值

无 (undefined)。

示例

下面的代码片段演示了如何创建一个包含两个范围的新高亮，然后使用 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 语言规范
# sec-map.prototype.foreach

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅