Cache.delete()

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.

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Метод delete() интерфейса Cache ищет запись Cache, чей ключ совпадает с запросом, и, в случае находки, удаляет запись Cache и возвращает Promise, который разрешается со значением true. Если запись не была найдена Cache, метод возвращает false.

Синтаксис

js
cache.delete(request,{options}).then(function(true) {
  // запись была удалена
});

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

Promise, который разрешается со значением true в случае, если запись была удалена, или false в другом случае.

Параметры

request

Request, который вы хотите удалить.

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

Объект, чьи свойства контролируют как будет выполняться сопоставление ключей при вызове delete. Допустимые значения:

  • 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.delete().

Примеры

js
caches.open("v1").then(function (cache) {
  cache.delete("/images/image.png").then(function (response) {
    someUIUpdateFunction();
  });
});

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

Specification
Service Workers
# cache-delete

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

BCD tables only load in the browser

Смотрите также