HighlightRegistry: values() 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 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 vergleichbar mit der Verwendung von Map.values().

Syntax

js
values()

Parameter

Keine.

Rückgabewert

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

Beispiele

Der folgende Code-Schnipsel zeigt, wie drei Highlight Objekte erstellt und registriert werden und wie der durch die values() Methode zurückgegebene Iterator verwendet 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 über die Hervorhebungen im Register mit einer for...of Schleife iteriert wird:

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

Browser-Kompatibilität

Siehe auch