BackgroundFetchRegistration.matchAll()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.
Метод matchAll() интерфейса BackgroundFetchRegistration возвращает массив всех совпавших объектов BackgroundFetchRecord.
Синтаксис
matchAll(request);
matchAll(request, options);
Параметры
request-
Requestдля которого вы пытаетесь найти записи. Может быть объектомRequestили URL. optionsНеобязательный-
Объект, который устанавливает параметры для операции
match. Доступные параметры:ignoreSearch-
Булево значение, которое определяет нужно ли игнорировать строку поиска в URL. Например, если параметр установлен как
true, то подстрока?value=bar, которая является частьюhttp://foo.com/?value=bar, будет игнорироваться при выполении сопоставления. Значение по умолчанию -false. ignoreMethod-
Булево значение. Если оно установлено как
true, то операциям сопоставления запрещается проверять методhttpобъектаRequest. Еслиfalse(значение по умолчанию) толькоGETиHEADразрешены. ignoreVary-
Булево значение. Когда
trueсигнализирует, что заголовокVARYдолжен быть проигнорирован. Значение по умолчанию -false.
Возвращаемое значение
Promise результатом обработки которого будет массив всех совпавших объектов BackgroundFetchRecord.
Exceptions
InvalidStateErrorDOMException-
Возвращается, если флаг
recordsAvailableустановлен какfalse, указывает на то, что запрос не выполняется.
Примеры
Используйте matchAll() без параметров, чтобы вернуть все записи в фоновом запросе.
const records = await bgFetch.matchAll();
console.log(records); // массив объектов BackgroundFetchRecord
Спецификации
| Specification |
|---|
| Background Fetch> # background-fetch-registration-match-all> |
Совместимость с браузерами
Loading…