Регистрация BackgroundFetch: метод matchAll()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

Экспериментально: Это экспериментальная технология.
Перед использованием в производстве внимательно проверьте таблицу совместимости с браузерами.

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

Метод matchAll() интерфейса BackgroundFetchRegistration возвращает массив соответствующих объектов BackgroundFetchRecord.

Синтаксис

matchAll()
matchAll(request)
matchAll(request,options)

Параметры

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

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

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

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

ignoreSearch Необязательно: Булево значение, указывающее, нужно ли игнорировать строку запроса в URL. Например, если установлено true, часть ?value=bar из http://foo.com/?value=bar будет проигнорирована при выполнении соответствия. По умолчанию false.
ignoreMethod Необязательно: Булево значение. Когда true, предотвращает операции сопоставления от проверки метода Request http. Если false (по умолчанию), разрешены только GET и HEAD.
ignoreVary Необязательно: Булево значение. Когда true указывает, что заголовок Vary должен быть проигнорирован. По умолчанию false.

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

Объект Promise, который разрешается массивом всех соответствующих объектов BackgroundFetchRecord.

Исключения

InvalidStateError DOMException: Возвращается, если флаг recordsAvailable равен false, что указывает на отсутствие текущего запроса.

Примеры

Используйте matchAll() без параметров, чтобы вернуть все записи в фоновом запросе.

const records = await bgFetch.matchAll();
console.log(records); // an array of BackgroundFetchRecord objects

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

Спецификация
Фоновый запрос # background-fetch-registration-match-all

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`matchAll`	74	79	Нет	62	Нет	74	Нет	53	Нет	11.0	Нет

© 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/BackgroundFetchRegistration/matchAll