HighlightRegistry: delete() Methode
Baseline
2025
Neu verfügbar
Seit June 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 delete() Methode der HighlightRegistry-Schnittstelle entfernt ein benanntes Highlight-Objekt aus der HighlightRegistry.
HighlightRegistry ist ein Map-ähnliches Objekt, sodass dies dem Einsatz von Map.delete() ähnelt.
Syntax
js
delete(customHighlightName)
Parameter
customHighlightName-
Der Name, als
String, desHighlight-Objekts, das aus derHighlightRegistryentfernt werden soll.
Rückgabewert
Gibt true zurück, wenn ein Highlight-Objekt unter dem angegebenen Namen in der HighlightRegistry war; andernfalls false.
Beispiele
Das folgende Codebeispiel registriert ein Highlight in der Registry und löscht es dann:
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® 2026 Language Specification # sec-map.prototype.delete |