Highlight: Methode values()
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 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-set.prototype.values> |