Cache
インターフェイスの keys()
メソッドは、Cache
キーの配列に解決される Promise
を返します。
リクエストは、挿入されたのと同じ順序で返されます。
注: レスポンスに VARY
ヘッダーが設定されている場合、URL が重複しているがヘッダーが異なるリクエストを返すことができます。
構文
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()
によって無視されることに注意してください。
戻り値
例
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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.