browsingData

使擴充套件程式能夠清除使用者在瀏覽時累積的資料。

browsingData API 中,瀏覽資料被劃分為幾種型別:

  • 瀏覽器快取
  • cookies
  • downloads
  • history
  • 本地儲存
  • 外掛資料
  • 儲存的表單資料
  • 儲存的密碼

您可以使用 browsingData.remove() 函式來刪除這些型別的任意組合。還有專門的函式用於刪除每種特定型別的資料,例如 removePasswords()removeHistory() 等等。

所有 browsingData.remove[X]() 函式都接受一個 browsingData.RemovalOptions 物件,您可以使用它來進一步控制資料刪除的兩個方面:

  • 要刪除資料的追溯時間範圍
  • 是僅從普通網頁刪除資料,還是也從託管的 Web 應用和附加元件中刪除資料。請注意,此選項在 Firefox 中尚未支援。

最後,此 API 提供了一個 browsingData.settings() 函式,它會為您提供瀏覽器內建的“清除歷史記錄”功能的當前設定值。

要使用此 API,您必須擁有“browsingData” API 許可權

型別

browsingData.DataTypeSet

用於指定要刪除的資料型別(例如,歷史記錄、下載、密碼等)的物件。

browsingData.RemovalOptions

用於指定要刪除資料的追溯時間範圍,以及是刪除透過普通網頁瀏覽、託管應用或附加元件新增的資料的物件。

方法

browsingData.remove()

刪除指定資料型別所對應的瀏覽資料。

browsingData.removeCache()

清除瀏覽器的快取。

browsingData.removeCookies()

刪除 cookies。

browsingData.removeDownloads()

刪除下載檔案列表。

browsingData.removeFormData()

清除已儲存的表單資料。

browsingData.removeHistory()

清除瀏覽器的歷史記錄。

browsingData.removeLocalStorage()

清除網站建立的任何 本地儲存

browsingData.removePasswords()

清除已儲存的密碼。

browsingData.removePluginData()

清除與外掛相關的資料。

browsingData.settings()

獲取瀏覽器“清除歷史記錄”功能中設定的當前值。

擴充套件程式示例

瀏覽器相容性

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