HighlightRegistry: values()-Methode

Limited availability

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

Die values()-Methode des HighlightRegistry-Interfaces gibt ein neues Iterator-Objekt zurück, das die Werte 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.values().

Syntax

js
values()

Rückgabewert

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

Beispiele

Der folgende Codeausschnitt zeigt, wie Sie drei Highlight-Objekte erstellen und registrieren und den Iterator verwenden, der von der values()-Methode zurückgegeben wird, um die Hervorhebungen 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.values();

console.log(iter.next().value); // Highlight
console.log(iter.next().value); // Highlight
console.log(iter.next().value); // Highlight

Das folgende Codebeispiel zeigt, wie man mit einer for...of-Schleife über die Hervorhebungen im Register 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 highlight of CSS.highlights.values()) {
  console.log(highlight); // Highlight
}

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-map.prototype.values

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch