HighlightRegistry: delete() 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 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, des Highlight-Objekts, das aus der HighlightRegistry entfernt 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

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

Browser-Kompatibilität

Siehe auch