Highlight: add() 方法

基准线 2025
新推出

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

Highlight 接口的 add() 方法向高亮(highlight)添加一个新的 Range 对象,并使用 CSS Custom Highlight API 进行样式设置。

Highlight 是一个类似于 Set 的对象,因此这与使用 Set.add() 类似。

语法

js
add(range)

参数

range

要添加到 Highlight 中的 Range 对象。

返回值

已添加范围的 Highlight 对象。

示例

以下代码片段展示了如何将两个范围添加到新的 highlight 对象中。

js
const highlight = new Highlight();

const range1 = new Range();
const range2 = new Range();

highlight.add(range1).add(range2);

console.log(highlight.size); // 2

规范

规范
ECMAScript® 2026 语言规范
# sec-set.prototype.add

浏览器兼容性

另见