HighlightRegistry: keys() 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 keys() của giao diện HighlightRegistry trả về một đối tượng Iterator mới chứa các khóa của mỗi đối tượng Highlight trong HighlightRegistry 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.keys().

Cú pháp

js
keys()

Tham số

Không có.

Giá trị trả về

Một đối tượng iterator mới chứa tên của mỗi đối tượng Highlight trong sổ đăng ký, theo thứ tự chèn.

Ví dụ

Đoạn code sau minh họa cách tạo và đăng ký ba đối tượng Highlight, và dùng iterator trả về từ phương thức keys() để ghi lại tên của chúng:

js
const fooHighlight = new Highlight();
const barHighlight = new Highlight();
const bazHighlight = new Highlight();

CSS.highlights.set("foo", fooHighlight);
CSS.highlights.set("bar", barHighlight);
CSS.highlights.set("baz", bazHighlight);

const iter = CSS.highlights.keys();

console.log(iter.next().value); // "foo"
console.log(iter.next().value); // "bar"
console.log(iter.next().value); // "baz"

Ví dụ sau minh họa cách duyệt qua các highlight trong sổ đăng ký bằng vòng lặp for...of:

js
const fooHighlight = new Highlight();
const barHighlight = new Highlight();
const bazHighlight = new Highlight();

CSS.highlights.set("foo", fooHighlight);
CSS.highlights.set("bar", barHighlight);
CSS.highlights.set("baz", bazHighlight);

for (const name of CSS.highlights.keys()) {
  console.log(name);
}

Thông số kỹ thuật

Specification
ECMAScript® 2027 Language Specification
# sec-map.prototype.keys

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

Xem thêm