Уведомления

Уведомления позволяют сообщать информацию о вашем расширении или его содержимом, используя службу уведомлений операционной системы.

Click notification in the top right corner of the browser window.

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

Настройка уведомлений

Вы управляете уведомлениями программно, используя API notifications. Для использования этого API вам необходимо запросить разрешение notifications в вашем файле manifest.json:

"permissions": ["notifications"]

Затем вы используете notifications.create для создания уведомлений, как в этом примере из notify-link-clicks-i18n:

const title = browser.i18n.getMessage("notificationTitle");
const content = browser.i18n.getMessage("notificationContent", message.url);
browser.notifications.create({
  type: "basic",
  iconUrl: browser.extension.getURL("icons/link-48.png"),
  title,
  message: content,
});

Этот код создаёт уведомление с иконкой, заголовком и сообщением.

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

browser.notifications.onClicked.addListener(handleClick);

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

Иконки

Подробности о создании иконок для использования с вашим уведомлением можно найти в разделе «Иконография» документации Iconography в системе дизайна Acorn.

Примеры

В репозитории webextensions-examples на GitHub есть пример notify-link-clicks-i18n, который реализует уведомления.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Notifications