HighlightRegistry: values() 方法

可用性有限

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

values() 方法是 HighlightRegistry 接口的方法，它返回一个新的 迭代器 对象，该对象包含 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 语言规范
# sec-map.prototype.values

浏览器兼容性

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

另请参阅