HighlightRegistry: values() Methode
Baseline
2025
Neu verfügbar
Seit June 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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
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:
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:
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
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-map.prototype.values |