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 zumHighlighthinzugefü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> |