chrome.sessions

refresh date: 2026-09-25 robots: noindex

說明

使用 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()

Promise

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

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

參數

• 篩選器

  篩選器 選填

• callback

  函式 選填

  callback 參數如下：

  (devices: Device[]) => void

  • 裝置

    裝置[]

    每個同步工作階段的 sessions.Device 物件清單，排序方式為從最近修改工作階段的裝置到最久未修改工作階段的裝置。tabs.Tab 物件會按照 sessions.Session 物件 windows.Window 中的新近程度排序。

傳回

• Promise<Device[]>

  Chrome 96 以上版本

  Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getRecentlyClosed()

Promise

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

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

參數

• 篩選器

  篩選器 選填

• callback

  函式 選填

  callback 參數如下：

  (sessions: Session[]) => void

  • sessions

    Session[]

    已關閉項目的清單，順序與關閉順序相反 (最近關閉的分頁或視窗會位於索引 0)。項目可能包含分頁或視窗。

傳回

• Promise<Session[]>

  Chrome 96 以上版本

  Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

restore()

Promise

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

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

參數

• sessionId

  字串 選填

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

• callback

  函式 選填

  callback 參數如下：

  (restoredSession: Session) => void

  • restoredSession

    工作階段

    包含還原 windows.Window 或 tabs.Tab 物件的 sessions.Session。

傳回

• Promise<Session>

  Chrome 96 以上版本

  Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

事件

onChanged

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

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

參數

• callback

  函式

  callback 參數如下：

  () => void