browser.sessions

说明

使用 chrome.sessions API 查询和恢复浏览会话中的标签页和窗口。

权限

sessions

类型

Device

属性

• deviceName

  字符串

  外部设备的名称。

• 专题演讲

  Session[]

  外部设备上打开的窗口会话列表，按会话修改时间从近到远排序。

Filter

属性

• maxResults

  number 可选

  要在请求的列表中提取的条目数上限。省略此参数可提取最大条目数 (sessions.MAX_SESSION_RESULTS)。

Session

属性

• lastModified

  数值

  窗口或标签页关闭或修改的时间，以自公元纪年开始的秒数表示。

• Tab

  标签页 （可选）

  tabs.Tab（如果此条目描述的是标签页）。系统将设置此字段或 sessions.Session.window。

• 窗口

  Window 可选

  windows.Window（如果此条目描述的是窗口）。系统将设置此字段或 sessions.Session.tab。

属性

MAX_SESSION_RESULTS

请求的列表中包含的 sessions.Session 数量上限。

值

25

方法

getDevices()

browser.sessions.getDevices(
  filter?: Filter,
): Promise<Device[]>

检索具有已同步会话的所有设备。

参数

• 过滤条件

  过滤条件 （可选）

返回

• Promise<Device[]>

  Chrome 96 及更高版本 browser.*（自 Chrome 148 起）

getRecentlyClosed()

browser.sessions.getRecentlyClosed(
  filter?: Filter,
): Promise<Session[]>

获取最近关闭的标签页和/或窗口的列表。

参数

• 过滤条件

  过滤条件 （可选）

返回

• Promise<Session[]>

  Chrome 96 及更高版本 browser.*（自 Chrome 148 起）

restore()

browser.sessions.restore(
  sessionId?: string,
): Promise<Session>

重新打开 windows.Window 或 tabs.Tab，并提供一个可选的回调函数，以便在条目恢复后运行。

参数

• sessionId

  字符串 可选

  windows.Window.sessionId 或 tabs.Tab.sessionId，用于恢复。如果未指定此参数，系统会恢复最近关闭的会话。

返回

• Promise<Session>

  Chrome 96 及更高版本 browser.*（自 Chrome 148 起）

事件

onChanged

browser.sessions.onChanged.addListener(
  callback: function,
)

在最近关闭的标签页和/或窗口发生更改时触发。此事件不会监控同步会话更改。

参数

• callback

  函数

  callback 参数如下所示：

  () => void