Cache.match()

Метод match() интерфейса Cache возвращает Promise, который разрешается в Response, ассоциированный с первым совпадающим запросом в объекте Cache. Если совпадений не найдено, Promise разрешается в undefined.

Синтаксис

cache.match(request,{options}).then(function(response) {
  //сделать что-нибудь с ответом
});

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

Promise, который разрешается в первый Response, который совпадает с запросом или в undefined, если совпадений не найдено.

Параметры

request

Запрос Request, который вы пытаетесь найти в Cache.

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

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

• ignoreSearch: Булево значение Boolean, которое указывает следует ли игнорировать строку запроса в url.  Например, если оно установлено в true, часть ?value=bar запроса https://foo.com/?value=bar будет проигнорирована при поиске соответствий ключа. По умолчанию равно false.
• ignoreMethod: Булево значение Boolean, которое, когда равно true, предотвращает проверку http метода для запроса  Request при выполнении сопоставлений ключа (обычно разрешены лишь GET и HEAD). По умолчанию равно false.
• ignoreVary: Булево значение Boolean, которое, когда установлено в true, указывает операции сопоставления ключа не проводить проверку соответствия заголовка VARY — т.е., если URL совпадает, вы получите соответствие независимо от того, установлен ли на объекте Response заголовок VARY. По умолчанию равно false.
• cacheName: Строка DOMString, задающая определенный кеш для поиска. Заметьте, что этот параметр игнорируется методом  Cache.match().

В Chrome поддерживается лишь cacheName.

Примеры

Код взят примера из примера пользовательская оффлайн страница (живой пример).

Следующий пример использует кеш для предоставления данных, когда запрос не удался. Выражение catch() выполняется когда вызов fetch() возбуждает исключение. Внутри выражения catch(), match() используется для возврата корректного ответа.

В этом примере, мы решили что кешироваться будут лишь HTML-документы полученные с помощью GET-запроса. Если условие if() равно false, то обработчик не будет вмешиваться в ответ. Если зарегистрированы другие обработчики получения данных, то у них будет шанс вызвать  event.respondWith(). Если ни один из обработчиков не вызовет event.respondWith(), запрос будет обработан браузером, как это было бы сделано без участия сервис воркера. Если fetch() возвращает валидный HTTP ответ к кодом из диапазона 4xx или 5xx, то метод catch() не будет вызван. 

self.addEventListener('fetch', function(event) {
  // Мы хотим выполнить лишь event.respondWith() если это GET-запрос HTML-документа.
  if (event.request.method === 'GET' &&
      event.request.headers.get('accept').indexOf('text/html') !== -1) {
    console.log('Handling fetch event for', event.request.url);
    event.respondWith(
      fetch(event.request).catch(function(e) {
        console.error('Fetch failed; returning offline page instead.', e);
        return caches.open(OFFLINE_CACHE).then(function(cache) {
          return cache.match(OFFLINE_URL);
        });
      })
    );
  }
});

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

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

• [1] Параметр options поддерживает только ignoreSearch и cacheName. 
• [2] Сервис воркеры (и Push) были отключены в Firefox 45 Extended Support Release (ESR.)

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

• Использование сервис воркеров
• Cache
• WorkerGlobalScope.caches