chrome.sessions

说明

使用 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()

<ph type="x-smartling-placeholder"></ph> 承诺

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

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

参数

• filter

  过滤（可选）

• callback

  函数（可选）

  callback 参数如下所示：

  (devices: Device[]) => void

  • 设备

    设备[]

    每个已同步会话的 sessions.Device 对象列表，按会话从最近修改过的设备到会话修改时间最少的设备进行排序。tabs.Tab 对象在 sessions.Session 对象的 windows.Window 中按新近度排序。

返回

• Promise<设备 []>

  Chrome 96 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getRecentlyClosed()

<ph type="x-smartling-placeholder"></ph> 承诺

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

参数

• filter

  过滤（可选）

• callback

  函数（可选）

  callback 参数如下所示：

  (sessions: Session[]) => void

  • 专题演讲

    会话[]

    已关闭条目的列表，按条目的关闭顺序排列（最近关闭的标签页或窗口位于索引 0 处）。条目可能包含标签页或窗口。

返回

• Promise<会话[]>

  Chrome 96 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

restore()

<ph type="x-smartling-placeholder"></ph> 承诺

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&lt;Session&gt;

  Chrome 96 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

事件

onChanged

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

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

参数

• callback

  函数

  callback 参数如下所示：

  () => void