BackgroundFetchUpdateUIEvent: метод updateUI()

Метод updateUI() интерфейса BackgroundFetchUpdateUIEvent обновляет заголовок и значок в пользовательском интерфейсе, чтобы отобразить состояние фонового запроса.

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

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

Объект, содержащий любое из следующего:

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

Список одного или нескольких ресурсов изображения, содержащих значки для использования в пользовательском интерфейсе. Ресурс изображения — это объект, содержащий:

src

Строка, представляющая URL изображения.

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

Строка, эквивалентная атрибуту sizes элемента <link>.

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

Строка, содержащая MIME-тип изображения.

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

Строка, предоставляющая имя связанного изображения.

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

Строка, содержащая новый заголовок пользовательского интерфейса.

Объект Promise.

InvalidStateError DOMException

Выбрасывается, если выполняется одно из следующих условий:

• Свойство isTrusted имеет значение false.
• Флаг обновления пользовательского интерфейса BackgroundFetchUpdateUIEvent уже установлен, что указывает на то, что метод updateUI() уже был вызван.
• BackgroundFetchUpdateUIEvent не активен.

Следующий пример демонстрирует обновление пользовательского интерфейса с заголовком и значком изображения при успешном запросе.

addEventListener("backgroundfetchsuccess", (event) => {
  event.updateUI({
    title: "Episode 5 ready to listen!",
    icon: {
      src: "path/to/success.ico",
      sizes: "16x16 32x32 64x64",
    },
  });
});