Cache.keys()

Cache インターフェイスの keys() メソッドは、Cache キーの配列に解決される Promise を返します。

リクエストは、挿入されたのと同じ順序で返されます。

: レスポンスに VARY ヘッダーが設定されている場合、URL が重複しているがヘッダーが異なるリクエストを返すことができます。

構文

cache.keys(request, {options}).then(function(keys) {
  // リクエストの配列で何かをする
});

パラメーター

request 省略可
特定のキーが必要な場合、返してほしい Request。 これは、Request オブジェクトまたは URL です。
options 省略可
プロパティが keys 操作でどのように照合するかを制御するオブジェクト。 使用可能なオプションは次のとおりです。
  • ignoreSearch: 照合操作で URL のクエリ文字列を無視するかどうかを指定する Booleantrue に設定すると、http://foo.com/?value=bar?value=bar 部分を、照合の実行時に無視します。 デフォルトは false です。
  • ignoreMethod: true に設定すると、照合操作が Request HTTP メソッドを検証しないようにする Boolean(通常、GET および HEAD のみが許可されます)。 デフォルトは false です。
  • ignoreVary: true に設定すると、VARY ヘッダーを照合しないように照合操作に指示する Boolean。 つまり、URL が一致した場合は、Response オブジェクトに VARY ヘッダーがあるかどうかに関係なく一致します。 デフォルトは false です。
  • cacheName: 検索対象の特定のキャッシュを表す DOMString。 このオプションは Cache.keys() によって無視されることに注意してください。

戻り値

Cache キーの配列に解決される Promise

caches.open('v1').then(function(cache) {
  cache.keys().then(function(keys) {
    keys.forEach(function(request, index, array) {
      cache.delete(request);
    });
  });
})

仕様

仕様 状態 コメント
Service Workers
Cache: keys の定義
草案 初期定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報