Highlight: forEach() 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 forEach()-Methode der Highlight-Schnittstelle führt eine bereitgestellte Funktion einmal für jedes Range-Objekt im Highlight-Objekt in der Einfügereihenfolge aus.
Highlight ist ein Set-ähnliches Objekt, daher ist dies ähnlich wie die Verwendung von Set.forEach().
Syntax
forEach(callbackFn)
forEach(callbackFn, thisArg)
Parameter
callback-
Funktion, die für jedes
Range-Objekt ausgeführt werden soll und drei Argumente nimmt:range,key-
Das aktuelle
Range-Objekt, das imHighlightverarbeitet wird. Da es inHighlightkeine Schlüssel gibt, wird dasrangefür beide Argumente übergeben. highlight-
Das
Highlight-Objekt, bei demforEach()aufgerufen wurde.
thisArg-
Wert, der als
thisbeim Ausführen voncallbackFnverwendet wird.
Rückgabewert
Keiner (undefined).
Beispiele
Der folgende Code zeigt, wie man ein neues Highlight mit zwei Bereichen erstellt und dann die Bereiche mithilfe der forEach()-Methode protokolliert:
function logRanges(range, key, highlight) {
console.log(`Highlight object ${highlight} contains range ${range}`);
}
const text = new Text("Time is an illusion. Lunchtime doubly so.");
const range1 = document.createRange();
range1.setStart(text, 0);
range1.setEnd(text, 4);
const range2 = document.createRange();
range2.setStart(text, 21);
range2.setEnd(text, 30);
const myHighlight = new Highlight();
myHighlight.add(range1);
myHighlight.add(range2);
myHighlight.forEach(logRanges);
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-set.prototype.foreach |
Browser-Kompatibilität
Loading…