说明
使用 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中按新近度排序。
-
返回
-
Chrome 96 及更高版本
Manifest V3 及更高版本支持 Promise，但为以下项目提供回调： 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
获取最近关闭的标签页和/或窗口的列表。
参数
返回
-
Chrome 96 及更高版本
Manifest V3 及更高版本支持 Promise，但为以下项目提供回调： 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
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，但为以下项目提供回调： 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
事件
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近关闭的标签页和/或窗口发生更改时触发。此事件不会监控已同步的会话更改。
参数
-
callback
函数
callback参数如下所示：() => void