說明
使用 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
方法
參數
- 篩選
篩選器 (選填)
傳回
-
Promise<Device[]>
Chrome 96 以上版本
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
): Promise<Session[]>
取得最近關閉的分頁和/或視窗清單。
參數
- 篩選
篩選器 (選填)
傳回
-
Promise<Session[]>
Chrome 96 以上版本
restore()
chrome.sessions.restore(
sessionId?: string,
): Promise<Session>
重新開啟 windows.Window 或 tabs.Tab，並在還原項目後執行選用回呼。
參數
- sessionId
字串 選填
按一下
windows.Window.sessionId或tabs.Tab.sessionId即可還原。如果未指定這項參數，系統會還原最近關閉的工作階段。
傳回
-
Promise<Session>
Chrome 96 以上版本
事件
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近關閉的分頁和/或視窗變更時觸發。這個事件不會監控同步工作階段的變更。
參數
- callback
函式
callback參數如下：() => void