ServiceWorkerGlobalScope: событие backgroundfetchfail

Событие backgroundfetchfail интерфейса ServiceWorkerGlobalScope срабатывает, когда операция background fetch завершается неудачно: то есть, когда хотя бы один сетевой запрос в процессе fetch не был успешно завершён.

Это событие не отменяется и не распространяется.

Используйте имя события в методах, таких как addEventListener(), или установите обработчик событий.

addEventListener("backgroundfetchfail", (event) => {});

onbackgroundfetchfail = (event) => {};

Объект BackgroundFetchUpdateUIEvent.

Наследует свойства от родительского класса BackgroundFetchEvent.

BackgroundFetchUpdateUIEvent.updateUI()

Обновляет пользовательский интерфейс элемента, отображаемого браузером, чтобы показать прогресс операции fetch.

Когда операция background fetch завершается неудачно (что означает, что по крайней мере один из отдельных сетевых запросов не был успешно завершён), браузер запускает сервис-воркер, если это необходимо, и вызывает событие backgroundfetchfail в глобальном контексте сервис-воркера.

В API background fetch браузер отображает пользователю элемент пользовательского интерфейса для отображения прогресса операции. В обработчике backgroundfetchfail сервис-воркер может обновить этот интерфейс, чтобы показать, что операция завершилась неудачно. Для этого обработчик вызывает метод updateUI() события, передавая новый заголовок и/или значки.

В обработчике этого события backgroundfetchfail, сервис-воркер также может очистить любые связанные данные для операции. Он также может получить и сохранить любые успешные ответы (например, используя API Cache). Для доступа к данным ответа сервис-воркер использует свойство registration события.

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

addEventListener("backgroundfetchfail", (event) => {
  event.updateUI({ title: "Could not complete download" });
});

• API background fetch