chrome.browsingData

更新日: 2026-09-25 robots: noindex

説明

chrome.browsingData API を使用して、ユーザーのローカル プロファイルから閲覧データを削除します。

権限

browsingData

マニフェスト

この API を使用するには、拡張機能のマニフェストで「browsingData」権限を宣言する必要があります。

{
  "name": "My extension",
  ...
  "permissions": [
    "browsingData",
  ],
  ...
}

用途

この API の最もシンプルなユースケースは、ユーザーの閲覧データを消去する時間ベースのメカニズムです。コードでは、ユーザーの閲覧データを削除する過去の日付を示すタイムスタンプを指定する必要があります。このタイムスタンプは、Unix エポックからの経過ミリ秒数としてフォーマットされます（getTime メソッドを介して JavaScript Date オブジェクトから取得できます）。

たとえば、ユーザーの過去 1 週間の閲覧データをすべて消去するには、次のようなコードを記述します。

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

chrome.browsingData.remove メソッドを使用すると、1 回の呼び出しでさまざまな種類の閲覧データを削除できます。これは、より具体的なメソッドを複数呼び出すよりもはるかに高速です。ただし、特定の種類の閲覧データ（Cookie など）のみを消去する場合は、よりきめ細かいメソッドを使用することで、JSON でいっぱいの呼び出しに代わる読みやすい方法を提供できます。

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.removeCookies({
  "since": oneWeekAgo
}, callback);

ユーザーがデータを同期している場合、chrome.browsingData.remove は同期アカウントの Cookie を消去した後に自動的に再構築することがあります。これは、同期を継続して、最終的にサーバー上のデータを削除できるようにするためです。ただし、より具体的な chrome.browsingData.removeCookies を使用して、同期アカウントの Cookie を消去できます。この場合、同期は一時停止されます。

特定のオリジン

特定のオリジンのデータを削除する場合や、一連のオリジンを削除対象から除外する場合は、RemovalOptions.origins パラメータと RemovalOptions.excludeOrigins パラメータを使用します。これらは、Cookie、キャッシュ、ストレージ（CacheStorage、FileSystems、IndexedDB、LocalStorage、ServiceWorkers、WebSQL）にのみ適用できます。

chrome.browsingData.remove({
  "origins": ["https://www.example.com"]
}, {
  "cacheStorage": true,
  "cookies": true,
  "fileSystems": true,
  "indexedDB": true,
  "localStorage": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

送信元の種類

API のオプション オブジェクトに originTypes プロパティを追加すると、影響を受けるオリジンの種類を指定できます。現在、オリジンは次の 3 つのカテゴリに分類されています。

  • unprotectedWeb は、ユーザーが特別な操作を行わずにアクセスするウェブサイトの一般的なケースを対象としています。originTypes を指定しない場合、API はデフォルトで、保護されていないウェブにおけるオリジンからデータを削除します。
  • protectedWeb は、ホステッド アプリケーションとしてインストールされたウェブにおけるオリジンを対象としています。たとえば、Angry Birds をインストールすると、オリジン https://chrome.angrybirds.com が保護され、unprotectedWeb カテゴリから削除されます。これらのオリジンのデータの削除をトリガーする場合は、注意が必要です。ゲームデータが完全に削除されるため、ユーザーが何を得るのかを把握していることを確認してください。必要以上に豚の小さな家を倒したいと思う人はいません。
  • extension は、chrome-extensions: スキームのオリジンを対象とします。拡張機能のデータを削除する場合も、細心の注意を払う必要があります。

前の例を調整して、保護されたウェブサイトのデータのみを削除するには、次のようにします。

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo,
  "originTypes": {
    "protectedWeb": true
  }
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

例

この API を試すには、chrome-extension-samples リポジトリから browsingData API の例をインストールします。

型

DataTypeSet

データ型のセット。欠落しているデータ型は false として解釈されます。

プロパティ

  • appcache

    boolean 省略可

    Chrome 152 以降、非推奨

    appcache のサポートが終了しました。このデータ型は無視されます。

    ウェブサイトの appcache。

  • キャッシュ

    boolean 省略可

    ブラウザのキャッシュ。

  • cacheStorage

    boolean 省略可

    Chrome 72 以降

    キャッシュ ストレージ

  • Cookie

    boolean 省略可

    ブラウザの Cookie。

  • ダウンロード

    boolean 省略可

    ブラウザのダウンロード リスト。

  • fileSystems

    boolean 省略可

    ウェブサイトのファイル システム。

  • formData

    boolean 省略可

    ブラウザに保存されているフォームデータ。

  • 履歴

    boolean 省略可

    ブラウザの履歴。

  • indexedDB

    boolean 省略可

    ウェブサイトの IndexedDB データ。

  • localStorage

    boolean 省略可

    ウェブサイトのローカル ストレージ データ。

  • 含まれていた

    boolean 省略可

    Chrome 144 以降で非推奨

    拡張機能によるパスワード削除のサポートが削除されました。このデータ型は無視されます。

    保存されているパスワード。

  • pluginData

    boolean 省略可

    Chrome 88 以降は非推奨

    Flash のサポートが終了しました。このデータ型は無視されます。

    プラグインのデータ。

  • serverBoundCertificates

    boolean 省略可

    Chrome 76 以降は非推奨

    サーバー バインド証明書のサポートが削除されました。このデータ型は無視されます。

    サーバーにバインドされた証明書。

  • serviceWorkers

    boolean 省略可

    Service Worker。

  • webSQL

    boolean 省略可

    Chrome 152 以降、非推奨

    WebSQL のサポートが削除されました。このデータ型は無視されます。

    ウェブサイトの WebSQL データ。

RemovalOptions

削除するデータを正確に指定するオプション。

プロパティ

  • excludeOrigins

    string[] 省略可

    Chrome 74 以降

    このリストにオリジンが存在する場合、そのオリジンのデータは削除から除外されます。origins と併用することはできません。Cookie、ストレージ、キャッシュでのみサポートされています。Cookie は、登録可能なドメイン全体で除外されます。

  • originTypes

    オブジェクト（省略可）

    プロパティで、クリアするオリジンタイプを指定するオブジェクト。このオブジェクトが指定されていない場合、デフォルトでは「保護されていない」オリジンのみが消去されます。「protectedWeb」または「extensions」を追加する前に、アプリケーション データを本当に削除する必要があるかどうかを確認してください。

    • 拡張機能

      boolean 省略可

      ユーザーがインストールした拡張機能とパッケージ化されたアプリケーション（細心の注意を払ってください）。

    • protectedWeb

      boolean 省略可

      ホステッド アプリケーションとしてインストールされているウェブサイト（注意してください）。

    • unprotectedWeb

      boolean 省略可

      通常のウェブサイト。

  • origins

    [string, ...string[]] 省略可

    Chrome 74 以降

    このポリシーが指定されている場合、このリストに含まれるオリジンのデータのみが削除されます。Cookie、ストレージ、キャッシュでのみサポートされています。登録可能なドメイン全体の Cookie が消去されます。

  • 開始:

    number 省略可

    この日付以降に蓄積されたデータを削除します。エポックからのミリ秒数で表されます（JavaScript の Date オブジェクトの getTime メソッドを介してアクセス可能）。指定しない場合、デフォルトは 0（すべての閲覧データを削除）になります。

メソッド

remove()

Promise 
chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
): Promise<void>

ユーザーのプロファイルに保存されているさまざまな種類の閲覧データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • dataToRemove

    DataTypeSet

    削除するデータ型のセット。

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    削除が完了すると解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeAppcache()

Promise Chrome 152 以降、非推奨
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

appcache のサポートが終了しました。この関数は効果がありません。

ウェブサイトの appcache データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトの appcache データが消去されると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeCache()

Promise 
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ブラウザのキャッシュを削除します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ブラウザのキャッシュを削除すると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeCacheStorage()

Promise Chrome 72 以降 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ウェブサイトのキャッシュ ストレージ データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトのキャッシュ ストレージがクリアされると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeCookies()

Promise 
chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

特定の期間内に変更されたブラウザの Cookie とサーバーバインド証明書を消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ブラウザの Cookie とサーバー バインド証明書が消去されると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeDownloads()

Promise 
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ブラウザのダウンロード済みファイルのリストを消去します（ダウンロードしたファイル自体は消去されません）。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ブラウザのダウンロード済みファイルのリストが消去されると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeFileSystems()

Promise 
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ウェブサイトのファイル システム データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトのファイル システムがクリアされると解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeFormData()

Promise 
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ブラウザに保存されているフォームデータ（自動入力）を削除します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ブラウザのフォームデータが消去されると解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeHistory()

Promise 
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ブラウザの履歴を消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ブラウザの履歴が消去されると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeIndexedDB()

Promise 
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ウェブサイトの IndexedDB データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトの IndexedDB データが消去されると解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeLocalStorage()

Promise 
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ウェブサイトのローカル ストレージ データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトのローカル ストレージが消去されると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removePasswords()

Promise Chrome 144 以降、非推奨
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

拡張機能によるパスワード削除のサポートが削除されました。この関数は効果がありません。

ブラウザに保存されているパスワードを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ブラウザのパスワードが消去されると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removePluginData()

Promise Chrome 88 以降は非推奨
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Flash のサポートが終了しました。この関数は効果がありません。

プラグインのデータを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    プラグインのデータが消去されると解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeServiceWorkers()

Promise Chrome 72 以降 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

ウェブサイトの Service Worker を消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトのサービス ワーカーがクリアされると解決します。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

removeWebSQL()

Promise Chrome 152 以降、非推奨
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

WebSQL のサポートが削除されました。この関数は効果がありません。

ウェブサイトの WebSQL データを消去します。

パラメータ

  • オプション

    RemovalOptions

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 96 以降

    ウェブサイトの WebSQL データベースが消去されると解決されます。

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

settings()

Promise 
chrome.browsingData.settings(
  callback?: function,
): Promise<object>

[閲覧履歴データの削除] 設定 UI で現在選択されているデータの種類を報告します。注: この API に含まれるデータタイプの一部は設定 UI で利用できません。また、一部の UI 設定は、ここに記載されている複数のデータタイプを制御します。

パラメータ

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    (result: object) => void

    • 件の結果

      オブジェクト

      • dataRemovalPermitted

        DataTypeSet

        すべてのタイプが結果に表示されます。削除が許可されている場合（エンタープライズ ポリシーなど）は true、許可されていない場合は false の値が表示されます。

      • dataToRemove

        DataTypeSet

        すべてのタイプが結果に表示されます。削除対象として選択され、削除が許可されている場合は true、それ以外の場合は false の値が表示されます。

      • オプション

        RemovalOptions

戻り値

  • Promise<object>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。