Benachrichtigungen
Mit Benachrichtigungen können Sie Informationen über Ihre Erweiterung oder deren Inhalte über den Benachrichtigungsdienst des zugrunde liegenden Betriebssystems übermitteln.
Benachrichtigungen können eine Handlungsaufforderung enthalten. Ihr Add-on kann erkennen, wenn der Benutzer auf die Benachrichtigung klickt oder sie geschlossen wird.
Benachrichtigungen festlegen
Sie verwalten Benachrichtigungen programmgesteuert mit der API notifications. Um diese API zu verwenden, müssen Sie in Ihrer manifest.json die Berechtigung notifications anfordern:
"permissions": ["notifications"]
Anschließend erstellen Sie Benachrichtigungen mit notifications.create, wie in diesem Beispiel aus 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.runtime.getURL("icons/link-48.png"),
title,
message: content,
});
Dieser Code erstellt eine Benachrichtigung mit einem Symbol, einem Titel und einer Nachricht.
Wenn die Benachrichtigung eine Handlungsaufforderung enthält, können Sie erkennen, wenn der Benutzer darauf klickt, und dann die Funktion aufrufen, die die Aktion verarbeitet:
browser.notifications.onClicked.addListener(handleClick);
Wenn Sie Handlungsaufforderungen über Benachrichtigungen ausgeben, sollten Sie außerdem die optionale Benachrichtigungs-id festlegen. So können Sie feststellen, welche Handlungsaufforderung der Benutzer ausgewählt hat.
Symbole
Einzelheiten zum Erstellen von Symbolen für Ihre Benachrichtigungen finden Sie unter Ikonografie in der Dokumentation zum Acorn Design System.
Beispiele
Das Repository webextensions-examples auf GitHub enthält das Beispiel notify-link-clicks-i18n, das Benachrichtigungen implementiert.