Highlight: forEach() 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 forEach() của giao diện Highlight thực thi một hàm được cung cấp một lần 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.forEach().
Cú pháp
forEach(callbackFn)
forEach(callbackFn, thisArg)
Tham số
callback-
Hàm thực thi cho mỗi đối tượng
Range, nhận ba đối số:range,key-
Đối tượng
Rangehiện tại đang được xử lý trongHighlight. Vì không có khóa trongHighlight,rangeđược truyền cho cả hai đối số. highlight-
Đối tượng
HighlightmàforEach()được gọi trên.
thisArg-
Giá trị để sử dụng làm
thiskhi thực thicallbackFn.
Giá trị trả về
Không có (undefined).
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 phương thức forEach():
function logRanges(range, key, highlight) {
console.log(`Highlight object ${highlight} contains range ${range}`);
}
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);
myHighlight.forEach(logRanges);
Thông số kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-set.prototype.foreach |