browser.sessions

說明

使用 chrome.sessions API 查詢及還原瀏覽工作階段的分頁和視窗。

權限

sessions

類型

Device

屬性

• deviceName

  字串

  外部裝置的名稱。

• sessions

  Session[]

  外部裝置開啟的視窗工作階段清單，依最近修改時間排序。

Filter

屬性

• maxResults

  數字 選填

  在要求的清單中，要擷取的項目數量上限。省略這個參數，即可擷取項目數量上限 (sessions.MAX_SESSION_RESULTS)。

Session

屬性

• lastModified

  數字

  視窗或分頁關閉或修改的時間，以自 Epoch 起經過的秒數表示。

• Tab 鍵

  分頁 選填

  tabs.Tab (如果這個項目描述的是分頁)。系統會設定這個欄位或 sessions.Session.window。

• 窗戶

  Window 選填

  windows.Window (如果這個項目描述的是視窗)。系統會設定這個欄位或 sessions.Session.tab。

屬性

MAX_SESSION_RESULTS

要求清單中可包含的 sessions.Session 數量上限。

值

25

方法

getDevices()

browser.sessions.getDevices(
  filter?: Filter,
): Promise<Device[]>

擷取所有具有同步工作階段的裝置。

參數

• 篩選器

  篩選器 選填

傳回

• Promise<Device[]>

  Chrome 96 以上版本 Chrome 148 以上版本中的 browser.*

getRecentlyClosed()

browser.sessions.getRecentlyClosed(
  filter?: Filter,
): Promise<Session[]>

取得最近關閉的分頁和/或視窗清單。

參數

• 篩選器

  篩選器 選填

傳回

• Promise<Session[]>

  Chrome 96 以上版本 Chrome 148 以上版本中的 browser.*

restore()

browser.sessions.restore(
  sessionId?: string,
): Promise<Session>

重新開啟 windows.Window 或 tabs.Tab，並在還原項目時執行選用的回呼。

參數

• sessionId

  字串 選填

  windows.Window.sessionId 或 tabs.Tab.sessionId 則可還原。如未指定這個參數，系統會還原最近關閉的工作階段。

傳回

• Promise<Session>

  Chrome 96 以上版本 Chrome 148 以上版本中的 browser.*

事件

onChanged

browser.sessions.onChanged.addListener(
  callback: function,
)

在最近關閉的分頁和/或視窗變更時觸發。這個事件不會監控同步工作階段的變更。

參數

• callback

  函式

  callback 參數如下：

  () => void