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 im Highlight verarbeitet wird. Da es in Highlight keine Schlüssel gibt, wird das range für beide Argumente übergeben.
highlight: Das Highlight-Objekt, bei dem forEach() aufgerufen wurde.

thisArg

Wert, der als this beim Ausführen von callbackFn verwendet 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