HighlightRegistry: entries() 方法

基準線 2025
新推出

自 2025 年 6 月起,此功能已在最新的裝置和瀏覽器版本中可用。此功能可能不適用於舊裝置或瀏覽器。

HighlightRegistry 介面的 entries() 方法返回一個新的 迭代器(Iterator) 物件,該物件按插入順序包含 HighlightRegistry 物件中每個元素的 [name, highlight] 對。

HighlightRegistry 是一個類似 Map 的物件,因此這與使用 Map.entries() 類似。

語法

js
entries()

引數

無。

返回值

一個新的迭代器物件,其中包含 HighlightRegistry 中每個 Highlight 物件的 [name, highlight] 陣列,按插入順序排列。

示例

下面的程式碼片段建立並註冊了兩個新的高亮,然後使用 entries() 方法返回的迭代器來記錄高亮及其名稱。

js
const myHighlight1 = new Highlight();
const myHighlight2 = new Highlight();

CSS.highlights.set("first-highlight", myHighlight1);
CSS.highlights.set("second-highlight", myHighlight2);

const iter = CSS.highlights.entries();

console.log(iter.next().value); // ['first-highlight', Highlight]
console.log(iter.next().value); // ['second-highlight', Highlight]

以下程式碼示例演示瞭如何使用 for...of 迴圈遍歷登錄檔中的高亮資訊

js
const myHighlight1 = new Highlight();
const myHighlight2 = new Highlight();

CSS.highlights.set("first-highlight", myHighlight1);
CSS.highlights.set("second-highlight", myHighlight2);

for (const [name, highlight] of CSS.highlights.entries()) {
  console.log(`Highlight ${name}`, highlight);
}

規範

規範
ECMAScript® 2026 語言規範
# sec-map.prototype.entries

瀏覽器相容性

另見