Benachrichtigungen
Benachrichtigungen ermöglichen es Ihnen, Informationen über Ihre Erweiterung oder deren Inhalt mithilfe des Benachrichtigungsdienstes des zugrunde liegenden Betriebssystems zu kommunizieren.
Benachrichtigungen können einen Handlungsaufruf für den Benutzer enthalten, und Ihr Add-on kann darauf hören, ob der Benutzer die Benachrichtigung anklickt oder sie schließt.
Benachrichtigungen spezifizieren
Sie verwalten Benachrichtigungen programmgesteuert mit der notifications API. Um diese API zu nutzen, müssen Sie die Berechtigung notifications in Ihrem manifest.json anfordern:
"permissions": ["notifications"]
Anschließend verwenden Sie notifications.create, um Ihre Benachrichtigungen zu erstellen, wie in diesem Beispiel von 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 Icon, einem Titel und einer Nachricht.
Wenn die Benachrichtigung einen Handlungsaufruf enthält, können Sie darauf hören, dass der Benutzer die Benachrichtigung anklickt, um die Funktion zum Ausführen der Aktion aufzurufen:
browser.notifications.onClicked.addListener(handleClick);
Wenn Sie über Benachrichtigungen zu Handlungsaufrufen aufrufen, sollten Sie auch die optionale Benachrichtigungs-id definieren, um herauszufinden, welchen Handlungsaufruf der Benutzer ausgewählt hat.
Icons
Für Details, wie Sie Icons erstellen, die Sie mit Ihrer Benachrichtigung verwenden, siehe Iconography in der Dokumentation des Acorn Design Systems.
Beispiele
Das webextensions-examples Repository auf GitHub enthält das notify-link-clicks-i18n Beispiel, das Benachrichtigungen implementiert.