HighlightRegistry: values() 方法

基准线 2025
新推出

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

HighlightRegistry 接口的 values() 方法返回一个新的 迭代器(Iterator) 对象,该对象按插入顺序包含 HighlightRegistry 对象中每个 Highlight 对象的值。

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

语法

js
values()

参数

无。

返回值

一个新的迭代器对象,其中包含注册表中的每个 Highlight 对象,按插入顺序排列。

示例

以下代码片段演示了如何创建和注册三个 Highlight 对象,并使用 values() 方法返回的迭代器来记录高亮信息

js
const fooHighlight = new Highlight();
const barHighlight = new Highlight();
const bazHighlight = new Highlight();

CSS.highlights.set("foo", fooHighlight);
CSS.highlights.set("bar", barHighlight);
CSS.highlights.set("baz", bazHighlight);

const iter = CSS.highlights.values();

console.log(iter.next().value); // Highlight
console.log(iter.next().value); // Highlight
console.log(iter.next().value); // Highlight

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

js
const fooHighlight = new Highlight();
const barHighlight = new Highlight();
const bazHighlight = new Highlight();

CSS.highlights.set("foo", fooHighlight);
CSS.highlights.set("bar", barHighlight);
CSS.highlights.set("baz", bazHighlight);

for (const highlight of CSS.highlights.values()) {
  console.log(highlight); // Highlight
}

规范

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

浏览器兼容性

另见