Highlight:values() 方法

有限可用性

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

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

浏览器兼容性

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

另请参阅