files/fr/mozilla/add-ons/webextensions/api/notifications/index.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

---
title: notifications
slug: Mozilla/Add-ons/WebExtensions/API/notifications
tags:
  - API
  - Add-ons
  - Extensions
  - Notifications
  - WebExtensions
translation_of: Mozilla/Add-ons/WebExtensions/API/notifications
---
{{AddonSidebar}}

Afficher les notifications à l'utilisateur, en utilisant le mécanisme de notification du système d'exploitation sous-jacent. Étant donné que cette API utilise le mécanisme de notification du système d'exploitation, les détails de l'apparence et du comportement des notifications peuvent varier en fonction du système d'exploitation et des paramètres de l'utilisateur.

Pour utiliser cette API, vous devez  avoir la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "notifications".

La notification est identique sur tous les systèmes d'exploitation de bureau. Quelque chose comme :

![](notification.png)

## Types

- {{WebExtAPIRef("notifications.NotificationOptions")}}
  - : Définit le contenu d'une notification.
- {{WebExtAPIRef("notifications.TemplateType")}}
  - : Le type de notification Par exemple, cela définit si la notification peut contenir une image.

## Fonctions

- {{WebExtAPIRef("notifications.clear()")}}
  - : Effacer une notification spécifique, compte tenu de son identifiant.
- {{WebExtAPIRef("notifications.create()")}}
  - :  Créez et affichez une nouvelle notification.
- {{WebExtAPIRef("notifications.getAll()")}}
  - : Recevez toutes les notifications
- {{WebExtAPIRef("notifications.update()")}}
  - : Mettre à jour une notification

## Evénements

- {{WebExtAPIRef("notifications.onButtonClicked")}}
  - : Lancé lorsque l'utilisateur a cliqué sur un bouton dans la notification.
- {{WebExtAPIRef("notifications.onClicked")}}
  - : Lancé lorsque l'utilisateur a cliqué sur la notification, mais pas sur un bouton.
- {{WebExtAPIRef("notifications.onClosed")}}
  - : Lancé lorsqu'une notification est fermée, soit par le système, soit parce que l'utilisateur l'a rejeté..
- {{WebExtAPIRef("notifications.onShown")}}
  - : Lancé immédiatement après l'affichage d'une notification.

## Compatibilité du navigateur

{{Compat("webextensions.api.notifications")}}

{{WebExtExamples("h2")}}

> **Note :**
>
> Cette API est basée sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications).