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

浏览器兼容性

另见