HighlightRegistry: clear() 方法

基准线 2025
新推出

自 2025 年 6 月起,此功能已在最新的设备和浏览器版本中可用。此功能可能不适用于旧设备或浏览器。

HighlightRegistry 接口的 clear() 方法会移除在 HighlightRegistry 中注册的所有 Highlight 对象。

HighlightRegistry 是一个类似 Map 的对象,因此这与使用 Map.clear() 类似。

语法

js
clear()

参数

无。

返回值

无(undefined)。

示例

下面的代码片段在注册表中注册了两个高亮对象,然后清空了注册表。

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

规范

规范
ECMAScript® 2026 语言规范
# sec-map.prototype.clear

浏览器兼容性

另见