Highlight: add() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

add() は Highlight インターフェイスのメソッドで、 CSS カスタムハイライト API を使用してスタイル設定される、新しい Range オブジェクトをハイライトに追加します。

Highlight は Set 風オブジェクトですので、これは Set.add() を使うのと似ています。

構文

js
add(range)

引数

range

この Highlight に追加する Range オブジェクトです。

返値

範囲が追加された Highlight オブジェクト。

例

以下のコードスニペットは、新しいハイライトオブジェクトに 2 つの範囲を追加する方法を示しています。

js
const highlight = new Highlight();

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

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

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

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-set.prototype.add

ブラウザーの互換性

関連情報