说明
使用 chrome.sessions
API 从浏览会话中查询和恢复标签页及窗口。
权限
sessions
类型
Device
属性
-
deviceName
字符串
外部设备的名称。
-
专题演讲
会话[]
外部设备打开的窗口会话的列表,按会话从最近修改到修改时间(由近到远)排序。
Filter
属性
-
maxResults
编号(选填)
要在请求的列表中提取的条目数上限。省略此参数可提取最大条目数 (
sessions.MAX_SESSION_RESULTS
)。
Session
属性
-
lastModified
number
窗口或标签页的关闭或修改时间,以从公元纪年开始计算的毫秒数表示。
-
Tab
Tab(可选)
tabs.Tab
(如果此条目描述的是标签页)。系统会设置此字段或sessions.Session.window
。 -
窗口
时间范围(可选)
windows.Window
(如果此条目描述的是窗口)。系统会设置此字段或sessions.Session.tab
。
属性
MAX_SESSION_RESULTS
所请求的列表中可包含的 sessions.Session
的数量上限。
值
25
方法
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
检索具有已同步会话的所有设备。
参数
-
filter
过滤(可选)
-
callback
函数(可选)
callback
参数如下所示:(devices: Device[]) => void
-
设备
设备[]
每个已同步会话的
sessions.Device
对象列表,按会话从最近修改过的设备到会话修改时间最少的设备进行排序。tabs.Tab
对象在sessions.Session
对象的windows.Window
中按新近度排序。
-
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
获取最近关闭的标签页和/或窗口的列表。
参数
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
重新打开 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 及更高版本只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
事件
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近关闭的标签页和/或窗口发生更改时触发。此事件不会监控已同步的会话更改。
参数
-
callback
函数
callback
参数如下所示:() => void