Highlight: entries() method
Baseline
2025
Newly available
Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Phương thức entries() của giao diện Highlight trả về một đối tượng Iterator mới chứa một mảng [range, range] cho mỗi đối tượng Range trong đối tượng Highlight, theo thứ tự chèn vào.
Highlight là một đối tượng giống Set, vì vậy điều này tương tự như sử dụng Set.entries().
Cú pháp
entries()
Tham số
Không có.
Giá trị trả về
Một đối tượng iterator mới chứa một mảng [range, range] cho mỗi đối tượng Range trong Highlight đã cho, theo thứ tự chèn vào.
Ví dụ
Đoạn mã dưới đây minh họa cách tạo một vùng làm nổi bật mới với hai phạm vi, rồi ghi lại các phạm vi bằng cách sử dụng iterator được trả về bởi phương thức entries():
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]
Ví dụ mã sau đây minh họa cách lặp qua các phạm vi trong một vùng làm nổi bật bằng cách sử dụng vòng lặp for...of:
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
}
Thông số kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-set.prototype.entries |