Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Highlight: add() Methode

Baseline 2025
Neu verfügbar

Seit June 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die add() Methode der Highlight-Schnittstelle fügt ein neues AbstractRange-Objekt zu einem Highlight hinzu, das mit der CSS Custom Highlight API gestylt werden soll.

Highlight ist ein Objekt ähnlich wie ein Set, daher ist dies vergleichbar mit der Verwendung von Set.add().

Syntax

js
add(range)

Parameter

range

Ein AbstractRange-Objekt, das zum Highlight hinzugefügt werden soll.

Rückgabewert

Das Highlight-Objekt mit dem hinzugefügten Bereich.

Beispiele

Der folgende Codeausschnitt zeigt, wie zwei Bereiche zu einem neuen Highlight-Objekt hinzugefügt werden:

js
const highlight = new Highlight();

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

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

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

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-set.prototype.add

Browser-Kompatibilität

Siehe auch