Highlight: values() 方法

基准线 2025
新推出

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

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

注意: keys() 方法是此方法的别名。它的行为完全相同,并返回 Highlight 元素的值。

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

语法

js
values()

参数

无。

返回值

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

示例

以下代码片段演示了如何使用三个 Range 对象创建一个新的 Highlight 对象,并使用 values() 方法返回的迭代器来记录这三个范围

js
const myHighlight = new Highlight();
myHighlight.add(new Range());
myHighlight.add(new Range());
myHighlight.add(new Range());

const iter = myHighlight.values();

for (value of iter) {
  console.log(value); // Range
}

规范

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

浏览器兼容性

另见