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.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Support complet 17Firefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
appIconMaskUrl
ObsolèteNon-standard
Chrome Support complet OuiEdge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera ?
Notes
?
Notes
Notes Specifying this option doesn't throw an error. It might or might not have any effect.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
buttonsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying the 'buttons' option will cause an asynchronous error on Opera.
Firefox Android Aucun support Non
contextMessageChrome Support complet 31Edge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored, on Opera 18 and above.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
eventTimeChrome Support complet OuiEdge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera ?
Notes
?
Notes
Notes Specifying this option doesn't throw an error. It might or might not have any effect.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
imageUrl
ObsolèteNon-standard
Chrome Support complet OuiEdge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
isClickableChrome Support complet 32Edge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera Aucun support Non
Notes
Aucun support Non
Notes
Notes Setting 'isClickable' to false will cause an asynchronous error on Opera 19 and above. Older Opera versions throw an error synchronously if this options is given.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
itemsChrome Support complet Oui
Notes
Support complet Oui
Notes
Notes On macOS only the first item is shown.
Edge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
priorityChrome Support complet OuiEdge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera Support complet OuiFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
progressChrome Support complet 30Edge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
Opera Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored, on Opera 17 and above.
Firefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored.
requireInteractionChrome Support complet 50Edge Aucun support NonFirefox Aucun support NonOpera Aucun support Non
Notes
Aucun support Non
Notes
Notes Specifying this option doesn't throw an error, but its value is ignored, on Opera 37 and above.
Firefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Remerciements :

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.

Étiquettes et contributeurs liés au document

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