HighlightRegistry: set() 方法

基準線 2025
新推出

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

HighlightRegistry 介面的 set() 方法在登錄檔中新增或更新具有指定名稱的 Highlight 物件。

HighlightRegistry 是一個類似 Map 的物件,因此這與使用 Map.set() 類似。

語法

js
set(name, highlight)

引數

name

要新增或更新的 Highlight 物件的名稱。名稱必須是 String

highlight

要新增或更新的 Highlight 物件。這必須是 Highlight 介面例項。

返回值

HighlightRegistry 物件。

示例

使用 set()

js
const fooHighlight = new Highlight();
CSS.highlights.set("foo", fooHighlight);

使用 set() 進行鏈式呼叫

由於 set() 方法返回登錄檔本身,您可以像下面這樣對方法呼叫進行鏈式操作

js
const fooHighlight = new Highlight();
const barHighlight = new Highlight();
const bazHighlight = new Highlight();

CSS.highlights
  .set("foo", fooHighlight)
  .set("bar", barHighlight)
  .set("baz", bazHighlight);

規範

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

瀏覽器相容性

另見