HighlightRegistry: forEach() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die forEach()-Methode der Schnittstelle HighlightRegistry führt eine bereitgestellte Funktion einmal für jedes Highlight-Objekt im Registry in der Einfügereihenfolge aus.

HighlightRegistry ist ein Map-ähnliches Objekt, daher ist dies ähnlich wie die Verwendung von Map.forEach().

Syntax

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

Parameter

callback

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

highlight

Das aktuelle Highlight.

name

Der Name des Highlights.

registry

Das Registry-Objekt, auf das forEach() aufgerufen wurde.

thisArg

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

Rückgabewert

Keiner (undefined).

Beispiele

Das folgende Codebeispiel 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

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch