Highlight: forEach() Methode
Baseline
2025
Neu verfügbar
Seit Juni 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 des Highlight Interfaces führt eine bereitgestellte Funktion einmal pro AbstractRange Objekt im Highlight Objekt in 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
AbstractRangeObjekt ausgeführt wird und drei Argumente nimmt:range,key-
Das aktuelle
AbstractRangeObjekt, das imHighlightverarbeitet wird. Da es keine Schlüssel inHighlightgibt, wird dasrangefür beide Argumente übergeben. highlight-
Das
HighlightObjekt, auf demforEach()aufgerufen wurde.
thisArg-
Wert, der als
thisbeim Ausführen voncallbackFnverwendet wird.
Rückgabewert
Keiner (undefined).
Beispiele
Der folgende Code-Schnipsel zeigt, wie Sie ein neues Highlight mit zwei Bereichen erstellen und dann die Bereiche mithilfe der forEach()-Methode protokollieren:
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 |