Highlight: entries()-Methode
Baseline
2025
Neu verfügbar
Seit Juni 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 Einfügereihenfolge enthält.
Highlight ist ein Set-ähnliches Objekt, daher ist dies ähnlich wie die 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
Der untenstehende Codeausschnitt zeigt, wie man ein neues Highlight mit zwei Bereichen erstellt und dann die Bereiche protokolliert, indem man den vom entries()-Methode zurückgegebenen Iterator verwendet:
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 über die Bereiche in einem Highlight iteriert, indem man eine for...of-Schleife verwendet:
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 |