W3cubDocs

/Web APIs

HighlightRegistry: delete() method

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.

The delete() method of the HighlightRegistry interface removes a the named Highlight object from the HighlightRegistry.

HighlightRegistry is a Map-like object, so this is similar to using Map.delete().

Syntax

delete(customHighlightName)

Parameters

customHighlightName: The name, as a String, of the Highlight object to remove from the HighlightRegistry.

Return value

Returns true if a Highlight object under the provided name was in the HighlightRegistry; otherwise false.

Examples

The following code sample registers a highlight in the registry, and then deletes it:

const myHighlight = new Highlight(range1, range2);

CSS.highlights.set("my-highlight", myHighlight);

CSS.highlights.delete("foo"); // false
CSS.highlights.delete("my-highlight"); // true

Specifications

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

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`delete`	105	105	140	91	17.2	105	140	72	17.2	20.0	105	17.2