HighlightRegistry: Methode delete()
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 Methode delete() der Schnittstelle HighlightRegistry entfernt das benannte Highlight-Objekt aus der HighlightRegistry.
HighlightRegistry ist ein Map-ähnliches Objekt. Die Methode funktioniert daher ähnlich wie Map.delete().
Syntax
js
delete(customHighlightName)
Parameter
customHighlightName-
Der Name des
Highlight-Objekts, das aus derHighlightRegistryentfernt werden soll, alsString.
Rückgabewert
Gibt true zurück, wenn sich ein Highlight-Objekt mit dem angegebenen Namen in der HighlightRegistry befand; andernfalls false.
Beispiele
Das folgende Codebeispiel registriert ein Highlight in der Registry und löscht es anschließend:
js
const myHighlight = new Highlight(range1, range2);
CSS.highlights.set("my-highlight", myHighlight);
CSS.highlights.delete("foo"); // false
CSS.highlights.delete("my-highlight"); // true
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-map.prototype.delete |