Modules

notifications.NotificationOptions

Ce type contient les données nécessaires pour :

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
iconUrlFacultatif
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.
contextMessageFacultatif
string. Du texte supplémentaire à afficher.
priorityFacultatif
number. La priorité de cette notification. Ça peut être 0, 1, or 2. La valeur par défaut est 0.
eventTimeFacultatif
number. Un timestamp en millisecondes pour cette notification depuis le timestamp 0.
buttonsFacultatif
array de button. 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.
iconUrlFacultatif
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'objet NotificationOptions est utilisé avec notifications.create(), mais optionel avec notifications.update().

items
array of item. 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.
Cette propriété est utilisable seuleument si le type de la notification est 'list'. Dans ce cas, cette propriété sera obligatoire si l'objet NotificationOptions est utilisé avec notifications.create(), mais optionel avec notifications.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'objet NotificationOptions est utilisé avec notifications.create(), mais optionel avec notifications.update().

Notez que les propriétés appIconMaskUrl et isClickable ne sont pas supportées.

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple (Oui) Non451481 (Oui)

1. Only 'type', 'iconUrl', 'title', and 'message' are supported.

Acknowledgements

Cette API est basée sur l'API chrome.notifications de Chromium.

Les informations de compatibilité avec Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous licence Creative Commons Attribution 3.0 United States.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1, Bat41
 Dernière mise à jour par : hellosct1,