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

瀏覽器相容性

另見