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

瀏覽器相容性