Skip to content

Latest commit

 

History

History
67 lines (53 loc) · 3.47 KB

File metadata and controls

67 lines (53 loc) · 3.47 KB
title slug
sessions.Session
Mozilla/Add-ons/WebExtensions/API/sessions/Session

{{AddonSidebar}}

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

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

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

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

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

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

类型

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

  • lastModified
  • tab{{optional_inline}}
    • : object。如果对象表示已关闭的选项卡,则此属性存在,并且将是 {{WebExtAPIRef("tabs.Tab")}} 对象。仅当扩展具有“tabs” 权限时,它才会包含 urltitlefavIconUrl
  • window{{optional_inline}}
    • : object。如果对象表示一个关闭的窗口,则此属性存在并且将是{{WebExtAPIRef("windows.Window")}}对象。

浏览器兼容性

{{Compat}}

Note

该 API 基于 Chromium 的 chrome.sessions API。