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 notificationtitle
string
. Le titre de la notificationiconUrl
Facultatifstring
. 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
Facultatifstring
. Du texte supplémentaire à afficher.priority
Facultatifnumber
. La priorité de cette notification. Ça peut être 0, 1, or 2. La valeur par défaut est 0.eventTime
Facultatifnumber
. Un timestamp en millisecondes pour cette notification depuis le timestamp 0.buttons
Facultatifarray
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
Facultatifstring
. 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 :-
title
string
. Le titre de cet élément.message
string
. Le message à afficher pour cet élément.
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 le
type
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é du navigateur
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
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.