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

瀏覽器相容性

另見