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

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

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.