sessions.Session

Session对象表示用户在当前浏览会话中已关闭的选项卡或窗口。

如果关闭了选项卡但未关闭其窗口,则会话以Tab对象表示:例如,因为用户单击了“关闭选项卡”按钮,并且此选项卡不是其窗口中的唯一选项卡。

如果关闭窗口,则会话表示为Window对象:例如,由于用户单击“关闭窗口”按钮,或关闭了窗口中唯一打开的选项卡。

请注意,不同的浏览器可能对会话何时为 Tab 和何时为 Window 有不同的想法。例如:

  • 在 Chrome 中,如果用户关闭包含多个标签的窗口,则会话将记录为“窗口”。如果用户关闭了仅包含一个选项卡的窗口,则该窗口将记录为一个选项卡。
  • 在 Firefox 中,如果用户关闭窗口(或该窗口中最后一个选项卡的选项卡),则将会话记录为窗口,如果用户关闭窗口中最后一个选项卡中的选项卡,则将会话记录为一个 Tab。

打开的选项卡的 Tab 对象没有sessionId。关闭选项卡时,它将具有一个sessionId但没有选项卡id。如果恢复了该标签页,它将获得一个新的标签页,id并且会丢失sessionId

类型

此类型的值是对象。它们包含以下属性:

lastModified

number。选项卡或窗口关闭的时间,自 epoch 以来的毫秒数

tab可选

object。如果对象表示已关闭的选项卡,则此属性存在,并且将是 tabs.Tab 对象。仅当扩展具有“tabs” 权限时,它才会包含 urltitlefavIconUrl

window可选

object。如果对象表示一个关闭的窗口,则此属性存在并且将是windows.Window对象。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
Session

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

备注: 该 API 基于 Chromium 的 chrome.sessions API。