notifications.NotificationOptions
Dieser Typ enthält alle Daten, die benötigt werden, um:
- eine Benachrichtigung mit
notifications.create()
zu erstellen, - eine bestehende Benachrichtigung mit
notifications.update()
zu aktualisieren.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die unten aufgeführten Eigenschaften.
Die ersten drei Eigenschaften - type
, title
, message
- sind bei notifications.create()
obligatorisch, bei notifications.update()
jedoch optional. Firefox unterstützt derzeit nur die Eigenschaften type
, title
, message
und iconUrl
; der einzige unterstützte Wert für type
ist 'basic'
.
type
-
notifications.TemplateType
. Der Typ der gewünschten Benachrichtigung. Abhängig von Ihrer Wahl hier sind bestimmte andere Eigenschaften entweder obligatorisch oder nicht zulässig. message
-
string
. Der Hauptinhalt der Benachrichtigung. title
-
string
. Der Titel der Benachrichtigung. iconUrl
Optional-
string
. Eine URL, die auf ein Symbol verweist, das in der Benachrichtigung angezeigt werden soll. Die URL kann sein: eine Daten-URL, eine Blob-URL, eine http- oder https-URL oder die relative URL einer Datei innerhalb der Erweiterung. Beim Verwenden eines SVG-Bildes stellen Sie sicher, dass das Bild Höhen- und Breitenattribute enthält, zum Beispiel<svg width="96" height="96"…
. Andernfalls wird das Bild möglicherweise nicht angezeigt. contextMessage
Optional-
string
. Ergänzender Inhalt zur Anzeige. priority
Optional-
number
. Die Priorität der Benachrichtigung: kann 0, 1 oder 2 sein. Standardmäßig 0, wenn weggelassen. eventTime
Optional-
number
. Ein Zeitstempel für die Benachrichtigung in Millisekunden seit dem Unix-Zeitstempel. -
array
vonbutton
. Ein Array von bis zu 2 Schaltflächen, die in der Benachrichtigung enthalten sein können. Sie können auf Klicks auf die Schaltflächen mithilfe vonnotifications.onButtonClicked
hören. Jede Schaltfläche wird als Objekt mit den folgenden Eigenschaften angegeben:title
-
string
. Titel der Schaltfläche. iconUrl
Optional-
string
. URL, die auf ein Symbol für die Schaltfläche verweist.
imageUrl
-
string
. Eine URL, die auf ein Bild verweist, das in der Benachrichtigung verwendet wird. Die URL kann sein: eine Daten-URL, eine Blob-URL oder die relative URL einer Datei innerhalb der Erweiterung. Beim Verwenden eines SVG-Bildes stellen Sie sicher, dass das Bild Höhen- und Breitenattribute enthält, zum Beispiel<svg width="96" height="96"…
. Andernfalls wird das Bild möglicherweise nicht angezeigt.Diese Eigenschaft ist nur zulässig, wenn
type
"image"
ist. In diesem Fall ist sie obligatorisch, wenn dieNotificationOptions
innotifications.create()
verwendet werden, und optional, wenn sie innotifications.update()
verwendet werden. items
-
array
vonitem
. Ein Array von Elementen, die in der Benachrichtigung enthalten sein sollen. Je nach den Einstellungen des Benachrichtigungsmechanismus des Betriebssystems werden möglicherweise nicht alle bereitgestellten Elemente angezeigt. Jedes Element wird als Objekt mit den folgenden Eigenschaften angegeben:title
-
string
. Titel, der im Element angezeigt werden soll. message
-
string
. Nachricht, die im Element angezeigt werden soll.
Diese Eigenschaft ist nur zulässig, wenn
type
"list"
ist. In diesem Fall ist sie obligatorisch, wenn dieNotificationOptions
innotifications.create()
verwendet werden, und optional, wenn sie innotifications.update()
verwendet werden. progress
-
integer
. Eine Ganzzahl zwischen 0 und 100, die den aktuellen Fortschritt in einem Fortschrittsindikator darstellt.Diese Eigenschaft ist nur zulässig, wenn
type
"progress"
ist. In diesem Fall ist sie obligatorisch, wenn dieNotificationOptions
innotifications.create()
verwendet werden, und optional, wenn sie innotifications.update()
verwendet werden.
Beachten Sie, dass appIconMaskUrl
und isClickable
nicht unterstützt werden.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.notifications
-API von Chromium chrome.notifications
.