拡張機能がユーザーのブラウズ中に蓄積したデータをクリアできるようにします。

 browsingData APIでは、ブラウズデータは下記の型に分けられます:

  • browser cache (ブラウザーキャッシュ)
  • cookies
  • downloads (ダウンロードデータ)
  • history (履歴)
  • local storage (ローカルストレージ)
  • plugin data (プラグインのデータ)
  • saved form data (保存したフォームデータ)
  • saved passwords (保存したパスワード)

これらの型の組み合わせを削除するのに browsingData.remove() 関数を使用できます。それぞれのデータ型を削除する専用関数もあり、例えば removePasswords(), removeHistory() などです。

すべての browsingData.remove[X]() 関数は browsingData.RemovalOptions オブジェクトを取って、これをデータ削除のその他2つの側面を管理するのに使うことができます:

  • データ削除を過去どれだけ遡れるのか
  • 通常のウェブページか、ホストされたウェブアプリも含めてデータ削除するのかのいずれか。このオプションは Firefox ではまだサポートされていないことに注意してください。

最後に、この API の browsingData.settings() 関数で、ブラウザー組み込みの「履歴消去」機能の現在の設定値を取得できます。

この API を使うには、"browsingData" の API パーミッションが必要です。

browsingData.DataTypeSet
削除データの型を指定するオブジェクト: 例えば、history, downloads, passwords, など
browsingData.RemovalOptions
データ削除するのにどれくらい以前に遡るのか、通常のウェブブラウジング/ホスト型アプリ/アドオンのどのデータを削除するのかを指定するオブジェクト。

メソッド

browsingData.remove()
指定された型のブラウジングデータを削除する
browsingData.removeCache()
ブラウザーキャッシュを消去する
browsingData.removeCookies()
cookies を削除する
browsingData.removeDownloads()
ダウンロード済みのファイルを削除する
browsingData.removeFormData()
保存されたフォームデータを消去する
browsingData.removeHistory()
ブラウザー履歴を消去する
browsingData.removeLocalStorage()
ウェブサイトが作成した local storage を消去する
browsingData.removePasswords()
パスワードを消去する
browsingData.removePluginData()
プラグインに関連するデータを消去する
browsingData.settings()
ブラウザーの「履歴消去」機能の現在の設定値を得る

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
removeChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53
補足
完全対応 53
補足
補足 Specifying dataTypes.history will also remove download history and service workers.
Opera 完全対応 ありFirefox Android 完全対応 57
補足
完全対応 57
補足
補足 Specifying dataTypes.history will also remove download history and service workers.
removeCacheChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53
補足
完全対応 53
補足
補足 removalOptions.since is not supported.
Opera 完全対応 ありFirefox Android 完全対応 57
補足
完全対応 57
補足
補足 removalOptions.since is not supported.
removeCookiesChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 完全対応 56
removeDownloadsChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 完全対応 57
removeFormDataChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 完全対応 57
removeHistoryChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53
補足
完全対応 53
補足
補足 This function also removes download history and service workers.
Opera 完全対応 ありFirefox Android 未対応 なし
補足
未対応 なし
補足
補足 See bug 1363010. browser.history.remove(options, {history:true}) can be used instead.
removeLocalStorageChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 57
補足
完全対応 57
補足
補足 removalOptions.since is not supported.
Opera 完全対応 ありFirefox Android 未対応 なし
補足
未対応 なし
補足
補足 The method is defined but returns a rejected promise.
removePasswordsChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 未対応 なし
補足
未対応 なし
補足
補足 See bug 1363012.
removePluginDataChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 未対応 なし
settingsChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 完全対応 56

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

Example extensions

謝辞

この API は Chromium の chrome.browsingData API に基づいています。

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

 

ドキュメントのタグと貢献者

このページの貢献者: takubokudori, Uemmra3
最終更新者: takubokudori,