Уведомление: Конструктор Notification()

Конструктор Notification() создаёт новый экземпляр объекта Notification, который представляет собой уведомление для пользователя.

title

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

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

Объект опций, содержащий любые пользовательские настройки, которые вы хотите применить к уведомлению. Возможные опции:

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

Должен быть не указан или пустым массивом. actions поддерживается только для постоянных уведомлений, отправленных из service worker с помощью ServiceWorkerRegistration.showNotification().

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

Строка, содержащая URL изображения, используемого для представления уведомления, когда нет достаточно места для отображения самого уведомления; например, панель уведомлений Android. На устройствах Android значок должен соответствовать устройствам с разрешением до 4x, приблизительно 96x96px, и изображение будет автоматически замаскировано.

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

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

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

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

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

Направление отображения уведомления. По умолчанию auto, которое просто принимает поведение настроек языка браузера, но вы можете переопределить это поведение, установив значения ltr и rtl (хотя большинство браузеров, похоже, игнорируют эти настройки).

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

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

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

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

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

Язык уведомления, указанный с помощью строки, представляющей тег языка в соответствии с RFC 5646: Теги для идентификации языков (также известный как BCP 47). См. страницу Sitepoint ISO 2-буквенных кодов языка для простой справки. По умолчанию пустая строка.

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

Булево значение, определяющее, должно ли пользователю быть отправлено уведомление после того, как старое уведомление заменится новым. По умолчанию false, что означает, что уведомление не будет отправлено. Если true, тогда tag также должно быть задано.

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

Указывает, что уведомление должно оставаться активным до тех пор, пока пользователь его не нажмёт или не закроет, а не закрывается автоматически. Значение по умолчанию false.

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

Булево значение, определяющее, должно ли уведомление быть беззвучным, т. е. не должно издаваться звуков или вибрации независимо от настроек устройства. Если установлено значение true, уведомление беззвучное; если установлено значение null (значение по умолчанию), применяются стандартные настройки устройства.

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

Строка, представляющая идентификационный тег для уведомления. По умолчанию пустая строка.

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

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

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

паттерн вибрации для вибрационной системы устройства, чтобы издавать вибрацию с уведомлением. Если указан, silent не должен быть true.

Экземпляр объекта Notification.

TypeError

Выбрасывается, если:

• Конструктор вызывается внутри ServiceWorkerGlobalScope.
• Указана опция actions и она не пустая.
• Опция silent установлена как true и опция vibrate указана.
• Опция renotify установлена как true, но опция tag пустая.

DataCloneError DOMException

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

Вот самый базовый пример, чтобы показать уведомление только в том случае, если разрешение уже предоставлено. Для более полных примеров см. страницу Notification.

if (Notification.permission === "granted") {
  const notification = new Notification("Hi there!");
}

Начиная с Chrome 49, уведомления не работают в режиме инкогнито.

Chrome для Android будет генерировать TypeError при вызове конструктора Notification. Он поддерживает только создание уведомлений из service worker. Подробнее см. отслеживатель проблем Chromium.

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