Cache.keys()

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

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

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

構文

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

パラメーター

request 省略可

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

options 省略可

プロパティが 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 Workers Cache: keys の定義	草案	初期定義

ブラウザーの互換性

BCD tables only load in the browser

Cache.keys()

構文

パラメーター

戻り値

例

仕様

ブラウザーの互換性

関連情報