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 AbstractRange Objekt im Highlight-Objekt aus, in Einfügereihenfolge.
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
AbstractRange-Objekt ausgeführt wird, mit drei Argumenten:range,key-
Das aktuelle
AbstractRange-Objekt, das imHighlightverarbeitet wird. Da es inHighlightkeine Schlüssel gibt, wird dasrangefür beide Argumente übergeben. highlight-
Das
Highlight-Objekt, auf dasforEach()aufgerufen wurde.
thisArg-
Wert, der als
thisverwendet wird, wenncallbackFnausgeführt wird.
Rückgabewert
Keiner (undefined).
Beispiele
Das folgende Code-Beispiel zeigt, wie ein neues Highlight mit zwei Bereichen erstellt wird, und dann wie die Bereiche durch die Verwendung der forEach()-Methode protokolliert werden:
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® 2027 Language Specification # sec-set.prototype.foreach |