tabs.highlight()

高亮(選擇)一個或多個標籤頁。標籤頁透過視窗 ID 和標籤索引範圍指定。

這是一個非同步函式,返回一個 Promise

語法

js
let highlighting = browser.tabs.highlight(
  highlightInfo         // object
)

引數

highlightInfo

object.

windowId 可選

integer. 包含標籤頁的視窗 ID。

populate 可選

boolean. 預設為 true。如果設定為 false,則 windows.Window 物件將不包含 tabs 屬性,該屬性包含代表視窗中開啟的標籤頁的 tabs.Tab 物件列表。

注意: 如果有很多標籤頁,填充視窗(預設行為)可能是一項耗時的操作。為了獲得更好的效能,建議當您不需要標籤頁詳細資訊時,手動將 populate 設定為 false

tabs

array of integer values. 指定要高亮的多個標籤頁索引。未包含在 tabs 中的先前已高亮的標籤頁將停止高亮。tabs 中的第一個標籤頁將成為活動標籤頁。

返回值

一個 Promise,它將使用一個 windows.Window 物件進行 fulfilled,該物件包含有關已高亮標籤頁的視窗的詳細資訊。如果找不到視窗或發生其他錯誤,Promise 將被拒絕並附帶錯誤訊息。

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.tabs API。本文件源自 Chromium 程式碼中的 tabs.json