chrome.sessions

說明

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

權限

sessions

類型

Device

屬性

  • deviceName

    字串

    外國裝置的名稱。

  • sessions

    外國裝置目前開啟的視窗工作階段清單,從最新到最近修改的工作階段排序。

Filter

屬性

  • maxResults

    編號 選填

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

Session

屬性

屬性

MAX_SESSION_RESULTS

要納入要求清單的sessions.Session數量上限。

25

方法

getDevices()

Promise
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

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

參數

  • 篩選器

    篩選器 選用

  • 回呼

    函式 選用

    callback 參數如下所示:

    (devices: Device[]) => void

傳回

  • Promise<裝置[]>

    Chrome 96 以上版本

    Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。

getRecentlyClosed()

Promise
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

參數

  • 篩選器

    篩選器 選用

  • 回呼

    函式 選用

    callback 參數如下所示:

    (sessions: Session[]) => void

    • sessions

      列出已關閉項目的清單,按倒序排序 (最近關閉的分頁或視窗會位於索引 0)。這些項目可能包含分頁或視窗。

傳回

  • Promise<Session[]>

    Chrome 96 以上版本

    Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。

restore()

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

重新開啟 windows.Windowtabs.Tab,並提供選用的回呼,在還原項目後執行。

參數

傳回

  • Promise&lt;Session&gt;

    Chrome 96 以上版本

    Promise 僅適用於 Manifest V3 及以上版本,其他平台需要使用回呼。

活動

onChanged

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

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

參數

  • 回呼

    函式

    callback 參數如下所示:

    () => void