HighlightRegistry: keys() メソッド

Baseline 2025
Newly available

Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

keys()HighlightRegistry インターフェイスのメソッドで、この HighlightRegistry オブジェクト内のすべての Highlight オブジェクトのキーを挿入順で含む新しいイテレーターオブジェクトを返します。

HighlightRegistryMap 風オブジェクトであるため、これは Map.keys() を使用するのと似ています。

構文

js
keys()

返値

レジストリーにあるすべての Highlight オブジェクトの名前を挿入順で格納する新しいイテレーターオブジェクト。

次のコードスニペットは、3 つの Highlight オブジェクトを作成して登録し、 keys() メソッドによって返されるイテレーターを使用してそれらの名前をログに記録する方法を示しています。

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.keys();

console.log(iter.next().value); // "foo"
console.log(iter.next().value); // "bar"
console.log(iter.next().value); // "baz"

次のサンプルコードは、 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 name of CSS.highlights.keys()) {
  console.log(name);
}

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-map.prototype.keys

ブラウザーの互換性

関連情報