API уведомлений

API уведомлений позволяет веб-страницам управлять отображением системных уведомлений для конечного пользователя. Эти уведомления выводятся вне области просмотра основного контекста браузера, поэтому они могут отображаться даже когда пользователь переключился на другую вкладку или перешел в другое приложение. API разработан для совместимости с существующими системами уведомлений на разных платформах.

На поддерживаемых платформах отображение системного уведомления обычно включает два этапа. Во-первых, пользователю необходимо предоставить текущему источнику разрешение на отображение системных уведомлений, что обычно выполняется при инициализации приложения или сайта, используя метод Notification.requestPermission(). Этот метод следует вызывать только при обработке пользовательского жеста, например, при обработке щелчка мышью. Например:

btn.addEventListener("click", () => {
  let promise = Notification.requestPermission();
  // wait for permission
});

Это запустит диалоговое окно запроса, примерно такого вида:

Здесь пользователь может выбрать, разрешить ли уведомления от этого источника или заблокировать их. После принятия решения, настройки обычно сохраняются для текущего сеанса.

Далее, создается новое уведомление с помощью конструктора Notification(). Требуется указать заголовок, а также, необязательно, объект настроек для указания параметров, таких как направление текста, текст тела, отображаемый значок, звуковой сигнал уведомления и другие.

Кроме того, спецификация API уведомлений определяет ряд дополнений к API ServiceWorker, чтобы позволить службам рабочих процессов отправлять уведомления.

Notification

Определяет объект уведомления.

NotificationEvent

Представляет событие уведомления, отправленное на ServiceWorkerGlobalScope объекта ServiceWorker.

notificationclick событие

Возникает при щелчке пользователя по отображаемому уведомлению.

notificationclose событие

Возникает при закрытии пользователем отображаемого уведомления.

ServiceWorkerRegistration.getNotifications()

Возвращает список уведомлений в порядке их создания текущим источником через текущую регистрацию службы рабочего процесса.

ServiceWorkerRegistration.showNotification()

Отображает уведомление с указанным заголовком.

• Использование API уведомлений