HighlightRegistry: keys()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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

Syntax

js
keys()

Rückgabewert

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

Beispiele

Der folgende Codeabschnitt zeigt, wie Sie drei Highlight-Objekte erstellen und registrieren und den Iterator verwenden, der von der keys()-Methode zurückgegeben wird, 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 Sie mit einer for...of-Schleife über die Highlights in der Registry iterieren:

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® 2025 Language Specification
# sec-map.prototype.keys

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch