HighlightRegistry: keys() Methode

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.

Die keys() Methode des HighlightRegistry-Interfaces gibt ein neues Iterator-Objekt zurück, das die Schlüssel für jedes Highlight-Objekt im HighlightRegistry-Objekt in Einfügereihenfolge enthält.

HighlightRegistry ist ein Map-ähnliches Objekt, daher ist dies ähnlich zur Verwendung von Map.keys().

Syntax

js
keys()

Parameter

Keine.

Rückgabewert

Ein neues Iterator-Objekt, das die Namen jedes Highlight-Objekts im Register in Einfügereihenfolge enthält.

Beispiele

Der folgende Codeausschnitt zeigt, wie man drei Highlight-Objekte erstellt und registriert und den Iterator, der von der keys()-Methode zurückgegeben wird, verwendet, um ihre Namen zu protokollieren:

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"

Das folgende Codebeispiel zeigt, wie man über die Highlights im Register mit einer for...of-Schleife iteriert:

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);
}

Spezifikationen

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

Browser-Kompatibilität

Siehe auch