HighlightRegistry: clear()-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 clear()-Methode der HighlightRegistry-Schnittstelle entfernt alle in der HighlightRegistry registrierten Highlight-Objekte.

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

Syntax

js
clear()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Beispiele

Der folgende Codeausschnitt registriert zwei Highlight-Objekte im Registry und löscht dann das Registry:

js
const customHighlight1 = new Highlight(range1, range2);
const customHighlight2 = new Highlight(range3, range4, range5);

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

console.log(CSS.highlights.size); // 2

CSS.highlights.clear();
console.log(CSS.highlights.size); // 0

Spezifikationen

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

Browser-Kompatibilität

Siehe auch