Highlight: entries() Methode
Baseline 2025Newly available
Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-set.prototype.entries |