HighlightRegistry: 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 HighlightRegistry thực thi một hàm đã cho một lần cho mỗi đối tượng Highlight trong sổ đăng ký, theo thứ tự chèn.

HighlightRegistry là một đối tượng tương tự Map, vì vậy thao tác này tương tự như dùng Map.forEach().

Cú pháp

js
forEach(callbackFn)
forEach(callbackFn, thisArg)

Tham số

callback

Hàm thực thi cho mỗi đối tượng Highlight, nhận ba đối số:

highlight

Highlight hiện tại.

name

Tên của highlight.

registry

Đối tượng sổ đăng ký mà forEach() được gọi trên đó.

thisArg

Giá trị dùng làm this khi thực thi callbackFn.

Giá trị trả về

Không có (undefined).

Ví dụ

Đoạn code dưới đây minh họa cách tạo một highlight mới với hai range, rồi ghi lại các range bằng phương thức forEach():

js
function logAllHighlights(highlight, name) {
  console.log(`Highlight ${name} exists in the registry`, highlight);
}

const customHighlight1 = new Highlight();
const customHighlight2 = new Highlight();
const customHighlight3 = new Highlight();

CSS.highlights.set("custom-highlight-1", customHighlight1);
CSS.highlights.set("custom-highlight-2", customHighlight2);
CSS.highlights.set("custom-highlight-3", customHighlight3);

CSS.highlights.forEach(logAllHighlights);

Thông số kỹ thuật

Thông số kỹ thuật
ECMAScript® 2027 Language Specification
# sec-map.prototype.foreach

Tương thích trình duyệt

Xem thêm