sessions
使用 sessions API 可以列出和恢复浏览器运行时已关闭的标签页和窗口。
sessions.getRecentlyClosed() 函数返回一个包含 tabs.Tab 和 windows.Window 对象的数组,这些对象代表自浏览器运行以来已关闭的标签页和窗口,最多可达 sessions.MAX_SESSION_RESULTS 中定义的数量。
您可以使用 sessions.restore() 函数来恢复窗口或标签页。恢复操作不仅仅是重新打开标签页,它还会恢复标签页的导航历史,以便前进/后退按钮能够正常工作。
此 API 还提供了一组函数,允许扩展程序存储与标签页或窗口关联的附加状态。然后,如果标签页或窗口被关闭并随后恢复,扩展程序就可以检索该状态。例如,一个标签页分组扩展程序可能会使用此功能来记住一个标签页属于哪个分组,以便在用户恢复标签页时将其恢复到正确的分组中。
要使用 sessions API,您必须拥有 "sessions" API 权限。
类型
sessions.Filter-
允许您限制调用
sessions.getRecentlyClosed()时返回的Session对象的数量。 sessions.Session-
代表用户在当前浏览会话中关闭的标签页或窗口。
属性
sessions.MAX_SESSION_RESULTS-
调用
sessions.getRecentlyClosed()时将返回的最大会话数量。
函数
sessions.forgetClosedTab()-
从浏览器最近关闭的标签页列表中移除一个已关闭的标签页。
sessions.forgetClosedWindow()-
从浏览器最近关闭的窗口列表中移除一个已关闭的窗口。
sessions.getRecentlyClosed()-
返回一个
Session对象的数组,代表在当前浏览会话(即自浏览器启动以来)中关闭的窗口和标签页。 sessions.restore()-
恢复一个已关闭的标签页或窗口。
sessions.setTabValue()-
存储与给定标签页关联的键/值对。
sessions.getTabValue()-
检索给定标签页之前存储的值,根据其键。
sessions.removeTabValue()-
从给定的标签页中移除键/值对。
sessions.setWindowValue()-
存储与给定窗口关联的键/值对。
sessions.getWindowValue()-
检索给定窗口之前存储的值,根据其键。
sessions.removeWindowValue()-
从给定的窗口中移除键/值对。
事件
sessions.onChanged-
当标签页或窗口关闭时触发。
扩展程序示例
浏览器兼容性
加载中…
注意: 此 API 基于 Chromium 的 chrome.sessions API。