HighlightRegistry: entries() 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 entries() Methode des HighlightRegistry Interfaces gibt ein neues Iterator Objekt zurück, das die [name, highlight] Paare für jedes Element im HighlightRegistry Objekt in der Reihenfolge ihrer Einfügung enthält.

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

Syntax

js
entries()

Parameter

Keine.

Rückgabewert

Ein neues Iterator-Objekt, das ein Array von [name, highlight] für jedes Highlight Objekt in der HighlightRegistry in der Reihenfolge ihrer Einfügung enthält.

Beispiele

Das untenstehende Codebeispiel erstellt und registriert zwei neue Highlights und protokolliert dann die Highlights und deren Namen, indem es den durch die entries() Methode zurückgegebenen Iterator verwendet:

js
const myHighlight1 = new Highlight();
const myHighlight2 = new Highlight();

CSS.highlights.set("first-highlight", myHighlight1);
CSS.highlights.set("second-highlight", myHighlight2);

const iter = CSS.highlights.entries();

console.log(iter.next().value); // ['first-highlight', Highlight]
console.log(iter.next().value); // ['second-highlight', Highlight]

Das folgende Codebeispiel zeigt, wie man mithilfe einer for...of Schleife über die Highlights im Register iteriert:

js
const myHighlight1 = new Highlight();
const myHighlight2 = new Highlight();

CSS.highlights.set("first-highlight", myHighlight1);
CSS.highlights.set("second-highlight", myHighlight2);

for (const [name, highlight] of CSS.highlights.entries()) {
  console.log(`Highlight ${name}`, highlight);
}

Spezifikationen

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

Browser-Kompatibilität

Siehe auch