Highlight: entries() 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 entries() Methode der Highlight-Schnittstelle gibt ein neues Iterator-Objekt zurück, das ein Array von [range, range] für jedes Range-Objekt im Highlight-Objekt in Einfügereihenfolge enthält.
Highlight ist ein Set-ähnliches Objekt, daher ist dies ähnlich zur Verwendung von Set.entries().
Syntax
entries()
Parameter
Keine.
Rückgabewert
Ein neues Iterator-Objekt, das ein Array von [range, range] für jedes Range-Objekt im gegebenen Highlight in Einfügereihenfolge enthält.
Beispiele
Der unten stehende Code-Schnipsel zeigt, wie ein neues Highlight mit zwei Bereichen erstellt wird und dann die Bereiche mit dem von der entries()-Methode zurückgegebenen Iterator protokolliert werden:
const text = new Text("Time is an illusion. Lunchtime doubly so.");
const range1 = document.createRange();
range1.setStart(text, 0);
range1.setEnd(text, 4);
const range2 = document.createRange();
range2.setStart(text, 21);
range2.setEnd(text, 30);
const myHighlight = new Highlight();
myHighlight.add(range1);
myHighlight.add(range2);
const iter = myHighlight.entries();
console.log(iter.next().value); // [Range, Range]
console.log(iter.next().value); // [Range, Range]
Das folgende Code-Beispiel zeigt, wie man über die Bereiche in einem Highlight mit einer for...of-Schleife iteriert:
const text = new Text("Time is an illusion. Lunchtime doubly so.");
const range1 = document.createRange();
range1.setStart(text, 0);
range1.setEnd(text, 4);
const range2 = document.createRange();
range2.setStart(text, 21);
range2.setEnd(text, 30);
const highlight = new Highlight();
highlight.add(range1);
highlight.add(range2);
for (const [range] of highlight.entries()) {
console.log(range.toString());
// Time
// Lunchtime
}
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-set.prototype.entries |