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()
によって無視されることに注意してください。
戻り値
例
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