Cache.keys()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.
Метод keys()
интерфейса Cache
возвращает Promise
, который разрешается в массив ключей Cache
.
Запросы возвращаются в том же порядке, в котором были добавлены.
Примечание: Запросы с дублирующимися URL, но с разными заголовками, могут быть возвращены, если в ответах на них установлен заголовок VARY
.
Синтаксис
cache.keys(request, { options }).then(function (keys) {
// сделать что-нибудь с вашим массивом запросов
});
Возвращаемое значение
Параметры
- request Необязательный
-
Request
который будет возвращён, если найден указанный ключ. - options Необязательный
-
Объект, чьи свойства контролируют то, как выполняется сопоставление ключей для операции
keys
. Допустимые параметры:ignoreSearch
: Булево значениеBoolean
, которое определяет должен ли процесс сопоставления игнорировать строку запроса в url. Если установлено вtrue
, часть?value=bar
запросаhttp://foo.com/?value=bar
будет проигнорирована при сопоставлении. По умолчанию установлено вfalse
.ignoreMethod
: Булево значениеBoolean
, которое, когда равноtrue
, предотвращает проверкуRequest
, при сопоставлении ключей, наHTTP
метод (обычно допускаются толькоGET
иHEAD
). По умолчанию установлено вfalse
.ignoreVary
: Булево значениеBoolean
, которое, когда равноtrue,
указывает операции сопоставления ключей не проводить проверку заголовкаVARY
. Другими словами, если URL совпадает, вы получите соответствие, независимо от того, есть ли заголовокVARY
на объекте запросаResponse
. По умолчанию установлено в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);
});
});
});
Спецификации
Specification |
---|
Service Workers # cache-keys |
Совместимость с браузерами
BCD tables only load in the browser