これは実験的な機能です。本番で使用する前にブラウザー実装状況をチェックしてください。

Cache インターフェースの add() メソッドは、URL を受け取り、取得して、指定されたキャッシュに結果のレスポンスオブジェクトを追加します。 add() メソッドは、機能的に次の例と同じです。

fetch(url).then(function(response) {
  if (!response.ok) {
    throw new TypeError('bad response status');
  }
  return cache.put(url, response);
})

より複雑な操作では、 Cache.put() を直接使用する必要があります。

メモ: add() は、リクエストにマッチする、前にキャッシュに保存されたキー/値の組を上書きます。

構文

cache.add(request).then(function() {
  // リクエストはすでに cahce に追加されている。
});

引数

request
キャッシュに加えるリクエスト。 Request オブジェクトか URL を指定できる。

返値

void で解決する Promise

例外

例外 発生条件
TypeError

URL スキームが httphttps ではありません。

レスポンスステータスが200番台(つまり、成功レスポンス)ではありません。これはリクエストが成功を返さない場合や、リクエストがオリジン間の CORS ではないリクエストの場合も発生します (この場合、ステータスが常に 0 で報告されます)。

このコードブロックは、InstallEvent が発火するのを待ってから、アプリにインストールプロセスを処理するために、waitUntil を実行します。この処理は、新しい cache を作成するための CacheStorage.open の呼び出しと、資産を追加するための Cache.add の使用で構成されています。

this.addEventListener('install', function(event) {
  event.waitUntil(
    caches.open('v1').then(function(cache) {
      return cache.add('/sw-test/index.html');
    })
  );
});

仕様策定状況

仕様書 策定状況 コメント
Service Workers
Cache の定義
草案 初回定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOS 版 SafariSamsung Internet
基本対応
実験的
Chrome 完全対応 44
補足
完全対応 44
補足
補足 Requires HTTPS from version 46.
Edge 完全対応 16Firefox 完全対応 39
補足
完全対応 39
補足
補足 Service workers (and Push) have been disabled in the Firefox 45 & 52 Extended Support Releases (ESR).
IE 未対応 なしOpera 完全対応 31
補足
完全対応 31
補足
補足 Requires HTTPS from version 33.
Safari 未対応 なしWebView Android 完全対応 44
補足
完全対応 44
補足
補足 Requires HTTPS from version 46.
Chrome Android 完全対応 44
補足
完全対応 44
補足
補足 Requires HTTPS from version 46.
Edge Mobile 未対応 なしFirefox Android 完全対応 39Opera Android 完全対応 31
補足
完全対応 31
補足
補足 Requires HTTPS from version 33.
Safari iOS 未対応 なしSamsung Internet Android 完全対応 4.0

凡例

完全対応  
完全対応
未対応  
未対応
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。

関連情報

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

このページの貢献者: mfuji09, YuichiNukiyama
最終更新者: mfuji09,