HighlightRegistry: clear()-Methode
Baseline 2025
Neu verfügbar
Seit Juni 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 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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-map.prototype.clear |