sessions.forgetClosedTab()

从浏览器最近关闭的标签页列表中移除一个已关闭的标签页。请注意,该标签页访问过的网站不会从浏览器的历史记录中移除。请使用 browsingDatahistory API 来移除历史记录。

这是一个异步函数,返回一个 Promise

语法

js
let forgettingTab = browser.sessions.forgetClosedTab(
  windowId,            // integer
  sessionId            // string
)

参数

windowId

Integer。要忘掉的标签页所属窗口的 ID。

sessionId

String。要忘掉的会话的 ID。

返回值

一个 Promise。该 Promise 将在会话被移除后,以无参数形式履行。

如果发生错误,Promise 将被拒绝并附带错误消息。

示例

此代码将忘掉最近关闭的单个会话,无论它是标签页还是窗口。

js
function forgetMostRecent(sessionInfos) {
  if (!sessionInfos.length) {
    console.log("No sessions found");
    return;
  }
  let sessionInfo = sessionInfos[0];
  if (sessionInfo.tab) {
    browser.sessions.forgetClosedTab(
      sessionInfo.tab.windowId,
      sessionInfo.tab.sessionId,
    );
  } else {
    browser.sessions.forgetClosedWindow(sessionInfo.window.sessionId);
  }
}

function onError(error) {
  console.log(error);
}

browser.sessions
  .getRecentlyClosed({ maxResults: 1 })
  .then(forgetMostRecent, onError);

浏览器兼容性