HighlightRegistry: 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 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

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:

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

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