notifications.NotificationOptions

Dieser Typ enthält alle Daten, die benötigt werden, um:

Typ

Werte dieses Typs sind Objekte. Sie enthalten die unten aufgeführten Eigenschaften.

Die ersten drei Eigenschaften - type, title, message - sind in notifications.create() erforderlich, aber optional in notifications.update(). 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 erforderlich 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 eine Data-URL, eine Blob-URL, eine http- oder https-URL oder die relative URL einer Datei innerhalb der Erweiterung sein. Wenn ein SVG-Bild verwendet wird, stellen Sie sicher, dass das Bild die Attribute „height“ und „width“ enthält, zum Beispiel <svg width="96" height="96"…. Andernfalls wird das Bild möglicherweise nicht angezeigt.

contextMessage Optional

string. Zusätzlicher 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 der Epoche.

buttons Optional

array von button. Ein Array von bis zu 2 Schaltflächen, die in die Benachrichtigung aufgenommen werden sollen. Sie können auf Klicks auf die Schaltflächen mit notifications.onButtonClicked reagieren. Jede Schaltfläche wird als Objekt mit den folgenden Eigenschaften angegeben:

title

string. Titel für die 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 werden soll. Die URL kann eine Data-URL, eine Blob-URL oder die relative URL einer Datei innerhalb der Erweiterung sein. Wenn ein SVG-Bild verwendet wird, stellen Sie sicher, dass das Bild die Attribute „height“ und „width“ 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 NotificationOptions in notifications.create() verwendet wird, und optional, wenn es in notifications.update() verwendet wird.

items

array von item. Ein Array von Elementen, die in die Benachrichtigung aufgenommen werden sollen. Abhängig von den Einstellungen des Benachrichtigungsmechanismus des Betriebssystems werden möglicherweise einige der angegebenen Elemente nicht angezeigt. Jedes Element wird als Objekt mit den folgenden Eigenschaften angegeben:

title

string. Der Titel, der im Element angezeigt werden soll.

message

string. Die Nachricht, die im Element angezeigt werden soll.

Diese Eigenschaft ist nur zulässig, wenn type "list" ist. In diesem Fall ist sie obligatorisch, wenn NotificationOptions in notifications.create() verwendet wird, und optional, wenn es in notifications.update() verwendet wird.

progress

integer. Ein ganzzahliger Wert zwischen 0 und 100, der den aktuellen Fortschritt in einem Fortschrittsanzeiger darstellt.

Diese Eigenschaft ist nur zulässig, wenn type "progress" ist. In diesem Fall ist sie obligatorisch, wenn NotificationOptions in notifications.create() verwendet wird, und optional, wenn es in notifications.update() verwendet wird.

Beachten Sie, dass appIconMaskUrl und isClickable nicht unterstützt werden.

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf Chromiums chrome.notifications API.