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