說明
使用 chrome.sessions API 查詢及還原瀏覽工作階段中的分頁和視窗。
權限
sessions類型
Device
屬性
-
deviceName
字串
外國裝置的名稱。
-
sessions
工作階段[]
外國裝置目前開啟的視窗工作階段清單，從最新到最近修改的工作階段排序。
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()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
擷取已同步工作階段的所有裝置。
參數
-
篩選器
篩選器 選用
-
回呼
函式 選用
callback參數如下所示：(devices: Device[]) => void
-
裝置
裝置[]
每個已同步工作階段的
sessions.Device物件清單，並按照最近修改工作階段的裝置排序，以及最近修改過工作階段的裝置。tabs.Tab物件會按照sessions.Session物件中的windows.Window新舊時間排序。
-
傳回
-
Promise<裝置[]>
Chrome 96 以上版本Promise 僅適用於 Manifest V3 及以上版本，其他平台需要使用回呼。
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
取得最近關閉的分頁和/或視窗清單。
參數
傳回
-
Promise<Session[]>
Chrome 96 以上版本Promise 僅適用於 Manifest V3 及以上版本，其他平台需要使用回呼。
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
重新開啟 windows.Window 或 tabs.Tab，並提供選用的回呼，在還原項目後執行。
參數
-
sessionId
string optional
要還原的
windows.Window.sessionId或tabs.Tab.sessionId。如未指定這個參數，系統會還原最近關閉的工作階段。 -
回呼
函式 選用
callback參數如下所示：(restoredSession: Session) => void
-
restoredSession
sessions.Session，內含還原的windows.Window或tabs.Tab物件。
-
傳回
-
Promise<Session>
Chrome 96 以上版本Promise 僅適用於 Manifest V3 及以上版本，其他平台需要使用回呼。
活動
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近關閉的分頁和/或視窗變更時觸發。這個事件不會監控已同步處理的工作階段變更。
參數
-
回呼
函式
callback參數如下所示：() => void