Метод Cache: keys()

Базовая реализация Широко доступна

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с апреля 2018 года.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна в Web Workers.

Метод keys() интерфейса Cache возвращает Promise, который разрешается в массив объектов Request, представляющих ключи кэша Cache.

Запросы возвращаются в том же порядке, в котором они были вставлены.

Примечание: Запросы с дублирующими URL, но различными заголовками могут быть возвращены, если у их ответов установлен заголовок VARY.

Синтаксис

keys()
keys(request)
keys(request, options)

Параметры

request Необязательно

Объект Request для возвращаемого ключа, если нужен конкретный ключ. Может быть объектом Request или URL.

options Необязательно

Объект, свойства которого управляют тем, как выполняется сопоставление в операции keys. Доступные параметры:

ignoreSearch: Булево значение, определяющее, следует ли игнорировать строку запроса в URL при сопоставлении. Если установлено в true, часть ?value=bar из http://foo.com/?value=bar будет проигнорирована при сопоставлении. По умолчанию false.
ignoreMethod: Булево значение, при установке в true, предотвращает проверку метода Request HTTP (обычно разрешены только GET и HEAD.) По умолчанию false.
ignoreVary: Булево значение, установленное в true, указывает операции сопоставления не выполнять сопоставление заголовков VARY. Другими словами, если URL совпадает, вы получите совпадение независимо от того, содержит ли объект Response заголовок VARY. По умолчанию false.
cacheName: Строка, представляющая кэш для поиска. Обратите внимание, что этот параметр игнорируется Cache.keys().

Возвращаемое значение

A Promise, разрешающийся в массив объектов Request.

Примеры

caches.open("v1").then((cache) => {
  cache.keys().then((keys) => {
    keys.forEach((request, index, array) => {
      cache.delete(request);
    });
  });
});

Спецификации

Спецификация
Service Workers # cache-keys

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`keys`	43	16	41	30	11.1	43	41	30	11.3	4.0	43

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Cache/keys