HighlightRegistry: entries() 方法

基准线 2025
新推出

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

HighlightRegistry 接口的 entries() 方法返回一个新的 迭代器(Iterator) 对象,该对象按插入顺序包含 HighlightRegistry 对象中每个元素的 [name, highlight] 对。

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

语法

js
entries()

参数

无。

返回值

一个新的迭代器对象,其中包含 HighlightRegistry 中每个 Highlight 对象的 [name, highlight] 数组,按插入顺序排列。

示例

下面的代码片段创建并注册了两个新的高亮,然后使用 entries() 方法返回的迭代器来记录高亮及其名称。

js
const myHighlight1 = new Highlight();
const myHighlight2 = new Highlight();

CSS.highlights.set("first-highlight", myHighlight1);
CSS.highlights.set("second-highlight", myHighlight2);

const iter = CSS.highlights.entries();

console.log(iter.next().value); // ['first-highlight', Highlight]
console.log(iter.next().value); // ['second-highlight', Highlight]

以下代码示例演示了如何使用 for...of 循环遍历注册表中的高亮信息

js
const myHighlight1 = new Highlight();
const myHighlight2 = new Highlight();

CSS.highlights.set("first-highlight", myHighlight1);
CSS.highlights.set("second-highlight", myHighlight2);

for (const [name, highlight] of CSS.highlights.entries()) {
  console.log(`Highlight ${name}`, highlight);
}

规范

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

浏览器兼容性

另见