Highlight: clear() 方法

基準線 2025
新推出

自 2025 年 6 月起,此功能已在最新的裝置和瀏覽器版本中可用。此功能可能不適用於舊裝置或瀏覽器。

clear() 方法是 Highlight 介面的一部分,它從一個 Highlight 物件中移除所有 Range 物件。

Highlight 是一個類似 Set 的物件,因此這與使用 Set.clear() 類似。

語法

js
clear()

引數

無。

返回值

無(undefined)。

示例

下面的程式碼片段展示瞭如何建立一個包含兩個 Range 的新高亮,然後清除它。

js
const highlight = new Highlight(range1, range2);
console.log(highlight.size); // 2

highlight.clear();
console.log(highlight.size); // 0

規範

規範
ECMAScript® 2026 語言規範
# sec-set.prototype.clear

瀏覽器相容性

另見