Highlight: Methode `values()`
Baseline 2025Newly 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 |