notifications.NotificationOptions

Aller à :
  1. Type
  2. Compatibilité du navigateur

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

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui174548 Oui
appIconMaskUrl Oui Non Non1 Non1 ?2
buttons Oui Non Non Non Non3
contextMessage31 Non Non1 Non1 Non4
eventTime Oui Non Non1 Non1 ?2
imageUrl Oui Non Non1 Non1 Non1
isClickable32 Non Non1 Non1 Non5
items Oui6 Non Non1 Non1 Non1
priority Oui Non Non1 Non1 Oui
progress30 Non Non1 Non1 Non7
requireInteraction50 Non Non Non Non8

1. Specifying this option doesn't throw an error, but its value is ignored.

2. Specifying this option doesn't throw an error. It might or might not have any effect.

3. Specifying the 'buttons' option will cause an asynchronous error on Opera.

4. Specifying this option doesn't throw an error, but its value is ignored, on Opera 18 and above.

5. 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.

6. On macOS only the first item is shown.

7. Specifying this option doesn't throw an error, but its value is ignored, on Opera 17 and above.

8. Specifying this option doesn't throw an error, but its value is ignored, on Opera 37 and above.

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

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