Highlight: Methode values()
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 der Highlight-Schnittstelle gibt ein neues Iterator-Objekt zurück, das die Werte für jedes Range-Objekt im Highlight-Objekt in Einfügereihenfolge enthält.
Hinweis:
Die keys()-Methode ist ein Alias für diese Methode. Sie verhält sich genau gleich und gibt Werte von Highlight-Elementen zurück.
Highlight ist ein Set-ähnliches Objekt, daher ähnelt dies der Verwendung von Set.values().
Syntax
values()
Parameter
Keine.
Rückgabewert
Ein neues Iterator-Objekt, das jedes Range-Objekt im gegebenen Highlight in Einfügereihenfolge enthält.
Beispiele
Der folgende Code-Schnipsel zeigt, wie man ein neues Highlight-Objekt mit drei Range-Objekten erstellt und den Iterator verwendet, der von der values()-Methode zurückgegeben wird, um die drei Bereiche zu protokollieren:
const myHighlight = new Highlight();
myHighlight.add(new Range());
myHighlight.add(new Range());
myHighlight.add(new Range());
const iter = myHighlight.values();
for (value of iter) {
console.log(value); // Range
}
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-set.prototype.values |