Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HighlightRegistry: 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 HighlightRegistry-Schnittstelle führt eine bereitgestellte Funktion einmal für jedes Highlight-Objekt in der Registrierung aus, in der Reihenfolge der Einfügung.

HighlightRegistry ist ein Map-ähnliches Objekt, daher ähnelt dies der Verwendung von Map.forEach().

Syntax

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

Parameter

callback

Funktion, die für jedes Highlight-Objekt ausgeführt wird und drei Argumente annimmt:

highlight

Das aktuelle Highlight.

name

Der Name des Highlights.

registry

Das Registrierungsobjekt, auf dem forEach() aufgerufen wurde.

thisArg

Wert, der als this verwendet wird, wenn callbackFn ausgeführt wird.

Rückgabewert

Keiner (undefined).

Beispiele

Der folgende Codeausschnitt zeigt, wie ein neues Highlight mit zwei Bereichen erstellt wird und dann die Bereiche mithilfe der forEach()-Methode protokolliert werden:

js
function logAllHighlights(highlight, name) {
  console.log(`Highlight ${name} exists in the registry`, highlight);
}

const customHighlight1 = new Highlight();
const customHighlight2 = new Highlight();
const customHighlight3 = new Highlight();

CSS.highlights.set("custom-highlight-1", customHighlight1);
CSS.highlights.set("custom-highlight-2", customHighlight2);
CSS.highlights.set("custom-highlight-3", customHighlight3);

CSS.highlights.forEach(logAllHighlights);

Spezifikationen

Spezifikation
ECMAScript® 2026 Language Specification
# sec-map.prototype.foreach

Browser-Kompatibilität

Siehe auch