notifications.NotificationOptions
Ce type contient les données nécessaires pour :
- créer une notification avec
notifications.create()
, - mettre à jour une notification avec
notifications.update()
.
Type
Les valeurs de ce type sont des objets qui contiennent les propriétés listées ci-dessous.
Les trois premières propriétés - type
, title
, message
- sont obligatoires pour notifications.create()
, mais pas avec notifications.update()
. Firefox ne supporte que les propriétés type
, title
, message
, et iconUrl
pour le moment, et le seul type
disponible est 'basic'
.
type
-
notifications.TemplateType
. Le type de notification que vous voulez. Selon votre choix ici, certaines propriétés seront soit nécéssaires, soit interdites. message
-
string
. Le contenu de la notification title
-
string
. Le titre de la notification iconUrl
Facultatif-
string
. Une URL correspondant vers une icône à afficher dans la notification. Ça peut être une URL de donnée, une URL blob, une URL http ou https, ou une l'URL relative d'un fichier de l'extension. contextMessage
Facultatif-
string
. Du texte supplémentaire à afficher. priority
Facultatif-
number
. La priorité de cette notification. Ça peut être 0, 1, or 2. La valeur par défaut est 0. eventTime
Facultatif-
number
. Un timestamp en millisecondes pour cette notification depuis le timestamp 0. -
array
debutton
. Un tableau pouvant contenir jusqu'à deux boutons à afficher dans la notification. Vous pouvez réagir aux clics sur ces boutons grâce ànotifications.onButtonClicked
. Chaque bouton est un objet avec ces propriétés :title
-
string
. Le texte du bouton. iconUrl
Facultatif-
string
. Une URL pointant vers l'icône de ce bouton.
imageUrl
-
string
. Une URL pointant vers une image à utiliser dans la notification. Ça peut être une URL de donnée, une URL blob, une URL http ou https, ou une l'URL relative d'un fichier de l'extension.Cette propriété est utilisable seuleument si le
type
de la notification est'image'
. Dans ce cas, cette propriété sera obligatoire si l'objetNotificationOptions
est utilisé avecnotifications.create()
, mais optionel avecnotifications.update()
. items
-
array
ofitem
. Un tableau d'éléments à inclure dans la notification. Selon les paramètres de notification du système d'exploitation, certains éléments que vous souhaitez afficher pourraient ne pas l'être. Chaque élément est un objet avec les propriétés suivantes :Cette propriété est utilisable seuleument si le
type
de la notification est'list'
. Dans ce cas, cette propriété sera obligatoire si l'objetNotificationOptions
est utilisé avecnotifications.create()
, mais optionel avecnotifications.update()
. progress
-
integer
. Une valeur entre 0 et 100, qui représente l'avancée actuelle d'un indicateur de progression. Cette propriété est utilisable seuleument si letype
de la notification est'progress'
. Dans ce cas, cette propriété sera obligatoire si l'objetNotificationOptions
est utilisé avecnotifications.create()
, mais optionel avecnotifications.update()
.
Notez que les propriétés appIconMaskUrl
et isClickable
ne sont pas supportées.
Compatibilité des navigateurs
BCD tables only load in the browser
Note :
Cette API est basée sur l'API chromium chrome.notifications
.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.