browsingData.removeCookies()

清除瀏覽器 cookie。

您可以使用 removalOptions 引數,它是一個 browsingData.RemovalOptions 物件,用於

  • 僅清除指定時間之後建立的 cookie
  • 控制是僅清除來自普通網頁設定的 cookie,還是同時清除來自託管應用和擴充套件程式設定的 cookie。

這是一個非同步函式,返回一個 Promise

語法

js
let removing = browser.browsingData.removeCookies(
  removalOptions            // RemovalOptions object
)

引數

removalOptions

object。一個 browsingData.RemovalOptions 物件,可用於僅清除指定時間之後建立的 cookie,以及控制是僅清除來自普通網頁設定的 cookie,還是同時清除來自託管應用和擴充套件程式設定的 cookie。

返回值

一個 Promise,當移除完成後,它將不帶引數地被 fulfilled。如果發生任何錯誤,該 Promise 將會使用錯誤訊息被 rejected。

示例

清除過去一週建立的 cookie

js
function onRemoved() {
  console.log("removed");
}

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

function weekInMilliseconds() {
  return 1000 * 60 * 60 * 24 * 7;
}

let oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeCookies({ since: oneWeekAgo })
  .then(onRemoved, onError);

清除所有 cookie

警告:使用此 API 清除所有 cookie 將同時清除所有本地儲存物件(包括其他擴充套件程式的本地儲存)。

如果您想在不干擾本地儲存的情況下清除所有 cookie,請使用 browser.cookies 來遍歷並移除所有 cookie 儲存的內容。

js
function onRemoved() {
  console.log("removed");
}

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

browser.browsingData.removeCookies({}).then(onRemoved, onError);

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.browsingData API。