このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Highlight: add() メソッド

Baseline 2025
最近利用可能

June 2025以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。

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

HighlightSet 風オブジェクトですので、これは 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

仕様書

仕様書
ECMAScript® 2027 Language Specification
# sec-set.prototype.add

ブラウザーの互換性

関連情報