windows.get()

語法

let getting = browser.windows.get(
  windowId,              // integer
  getInfo                // optional object
)

引數

windowId

integer。您希望返回的視窗物件的 ID。

getInfo 可選

object。包含用於過濾視窗型別的選項。

populate 可選

boolean。如果設定為 true，則 windows.Window 物件將包含一個 tabs 屬性，其中包含代表該視窗中開啟的標籤頁的 tabs.Tab 物件列表。僅當擴充套件的 manifest 檔案包含 "tabs" 許可權或匹配的 主機許可權 時，Tab 物件才包含 url、title 和 favIconUrl 屬性。

windowTypes 可選

array of windows.WindowType 物件。如果設定，返回的 windows.Window 將根據其型別進行過濾。如果未設定，預設過濾器為 ['normal', 'panel', 'popup']，其中 'panel' 視窗型別僅限於擴充套件自身擁有的視窗。

返回值

一個 Promise，它將以一個 windows.Window 物件（包含視窗的詳細資訊）來 fulfilled。如果發生任何錯誤，Promise 將會以錯誤訊息被 rejected。

示例

此示例獲取當前視窗並記錄其中包含的標籤頁的 URL。請注意，您需要 "tabs" 許可權或匹配的 主機許可權才能訪問標籤頁 URL。

function logTabs(windowInfo) {
  for (const tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  browser.windows.get(tab.windowId, { populate: true }).then(logTabs, onError);
});

瀏覽器相容性