說明
使用 chrome.sessions API 查詢及還原瀏覽工作階段的分頁和視窗。
權限
sessions類型
Device
屬性
- deviceName
字串
外部裝置的名稱。
- sessions
工作階段[]
外來裝置的開啟視窗工作階段清單，依最近修改時間排序。
Filter
屬性
- maxResults
號碼 選填
要求清單中要擷取的項目數量上限。如要擷取最多項目 (
sessions.MAX_SESSION_RESULTS)，請省略這個參數。
Session
屬性
- lastModified
數字
視窗或分頁關閉或修改的時間，以自 Epoch 以來的秒數表示。
- 分頁
分頁 選填
如果這個項目說明的是分頁，則為
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,
): Promise<Device[]>
擷取所有已同步工作階段的裝置。
參數
- 篩選
篩選器 (選填)
- callback
函式 選用
callback參數如下：(devices: Device[]) => void
- 裝置
裝置[]
每個同步處理工作階段的
sessions.Device物件清單，會依據工作階段的修改時間排序，從最近修改的裝置到最久之前修改的裝置。tabs.Tab物件會依時間順序排序，並顯示在sessions.Session物件的windows.Window中。
-
傳回
-
Promise<Device[]>
Chrome 96 以上版本只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
): Promise<Session[]>
取得最近關閉的分頁和/或視窗清單。
參數
傳回
-
Promise<Session[]>
Chrome 96 以上版本只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。
restore()
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 以上版本只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。
事件
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近關閉的分頁和/或視窗變更時觸發。這個事件不會監控同步工作階段的變更。
參數
- callback
函式
callback參數如下：() => void