Cache.keys()

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

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

構文

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

パラメーター

request Optional

特定のキーが必要な場合、返してほしい Request。 これは、Request オブジェクトまたは URL です。

options Optional

プロパティが keys 操作でどのように照合するかを制御するオブジェクト。 使用可能なオプションは次のとおりです。

• ignoreSearch: 照合操作で URL のクエリ文字列を無視するかどうかを指定する Boolean。 true に設定すると、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 worker の使用
• Cache
• WorkerGlobalScope.caches