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 AbstractRange-Objekt im Highlight-Objekt in der Einfügereihenfolge enthält.
Highlight ist ein Set-ähnliches Objekt, daher ist dies vergleichbar mit der Verwendung von Set.entries().
Syntax
entries()
Parameter
Keine.
Rückgabewert
Ein neues Iterator-Objekt, das ein Array von [range, range] für jedes AbstractRange-Objekt im gegebenen Highlight in Einfügereihenfolge enthält.
Beispiele
Das folgende Code-Snippet zeigt, wie man ein neues Highlight mit zwei Bereichen erstellt und dann die Bereiche mithilfe des Iterators, der von der entries()-Methode zurückgegeben wird, protokolliert:
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 Codebeispiel zeigt, wie man die Bereiche in einem Highlight mit einer for...of-Schleife durchläuft:
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® 2027 Language Specification> # sec-set.prototype.entries> |