browsingData.remove()

移除指定的瀏覽資料。

要移除的瀏覽資料在 dataTypes 選項中指定,它是一個 browsingData.DataTypeSet 物件。

您可以使用 removalOptions 選項,它是一個 browsingData.RemovalOptions 物件,來控制清除資料的時限,以及是僅從普通網頁移除資料,還是同時從託管應用和擴充套件中移除資料。

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

語法

js
let removing = browser.browsingData.remove(
  removalOptions,            // RemovalOptions object
  dataTypes                  // DataTypeSet object
)

引數

removalOptions

object。一個 browsingData.RemovalOptions 物件,可用於控制清除資料的時限,以及是否從託管的 Web 應用和擴充套件中移除資料,或者僅從普通網頁中移除資料。

dataTypes

object。一個 browsingData.DataTypeSet 物件,描述要移除的資料型別(例如,歷史記錄、下載記錄等)。

返回值

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

示例

移除過去一週的下載歷史記錄和瀏覽歷史記錄

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
  .remove({ since: oneWeekAgo }, { downloads: true, history: true })
  .then(onRemoved, onError);

移除所有下載記錄和瀏覽歷史記錄

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

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

browser.browsingData
  .remove({}, { downloads: true, history: true })
  .then(onRemoved, onError);

擴充套件程式示例

瀏覽器相容性

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