sessions.forgetClosedTab()

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

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

语法

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

参数

windowId

整数。您要忘记的标签所在的窗口的 ID。

sessionId

字符串。您要忘记的会话的 ID。

返回值

一个 Promise。当会话被删除时,它将以无参数的形式完成。

如果发生错误,该 promise 将以错误消息的形式被拒绝。

浏览器兼容性

BCD 表格只在浏览器中加载

示例

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

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);