Highlight: values() メソッド
Baseline 2025Newly available
Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
values() は Highlight インターフェイスのメソッドで、Highlight オブジェクト内のすべての Range オブジェクトの値を挿入順に含む新しいイテレーターオブジェクトを返します。
メモ: keys() メソッドはこのメソッドの別名です。 Highlight 要素の values とまったく同じ動作をし、同じものを返します。
Highlight は Set 風オブジェクトですので、これは Set.values() を使うのと似ています。
構文
js
values()
返値
指定された Highlight 内の各 Range オブジェクトを挿入順に反復処理する、新しいイテレーターオブジェクト。
例
次のコードスニペットは、3 つの Range オブジェクトを使用して新しい Highlight オブジェクトを作成し、 values() メソッドによって返されるイテレーターを使用して 3 つの範囲をログに記録する方法を示しています。
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
}
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-set.prototype.values |