recursal/MDN huggingface dataset:
Notification.image
==================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`image`** de l'interface `Notification` contient l'URL d'une image à afficher dans le cadre de la notification, comme définis à l'aide de l'option `image` lors de la création de la notification à l'aide du constructeur  `Notification()`.

Syntaxe
-------


```js
Notification.image;
```

### Valeur

Une `USVString`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # image-resource |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.icon
=================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`icon`** de l'interface `Notification` contient l'URL d'une icône à afficher dans le cadre de la notification, comme définis à l'aide de l'option `icon` lors de la création de la notification à l'aide du constructeur  `Notification()`.

Syntaxe
-------


```js
Notification.icon;
```

### Valeur

Une `USVString`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-icon |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.timestamp
======================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`timestamp`** de l'interface `Notification` renvoie un `DOMTimeStamp`, comme définis à l'aide de l'option `timestamp` lors de la création de la notification à l'aide du constructeur `Notification()`.

L'horodatage de la notification peut représenter le moment, en millisecondes depuis 00:00:00 UTC le 1er janvier 1970, de l'événement pour lequel la notification a été créée, ou il peut s'agir d'un horodatage arbitraire que vous souhaitez associer à la notification. Par exemple, un horodatage pour une réunion à venir pourrait être défini dans le futur, tandis qu'un horodatage pour un message manqué pourrait être défini dans le passé.

Syntaxe
-------


```js
Notification.timestamp;
```

### Valeur

Un `DOMTimeStamp`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-timestamp |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.renotify
=====================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`renotify`** de l'interface `Notification` spécifie si l'utilisateur doit être notifié après qu'une nouvelle notification remplace l'ancienne, comme spécifié comme définis à l'aide de l'option `renotify` lors de la création de la notification à l'aide du constructeur  `Notification()`.

Syntaxe
-------


```js
Notification.renotify;
```

### Valeur

Un `Boolean` (en-US). `false` est la valeur par défaut; `true` oblige la notification à renotifier l'utilisateur.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-renotify |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.title
==================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`title`** de l'interface `Notification` indique le titre de la notification, comme définis à l'aide de l'option `silent` lors de la création de la notification à l'aide du constructeur `Notification()` constructeur.

Syntaxe
-------


```js
Notification.title;
```

### Valeur

Une `DOMString`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-title |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.onshow
===================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété **`onshow`** de l'interface `Notification` définit un écouteur d'événements pour recevoir des événements `show`. Ces événements se produisent lorsqu'une `Notification` est affiché.

Syntaxe
-------


```js
Notification.onshow = function() { ... }
Notification.onshow = () => { ... }
```

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Notification`
* Utilisation de l'API Notifications
Notification.badge
==================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété **`badge`** de l'interface `Notification` renvoie l'URL de l'image utilisée pour représenter la notification lorsqu'il n'y a pas assez d'espace pour afficher la notification elle-même.

Syntaxe
-------


```js
const url = Notification.badge;
```

### Valeur

Une `USVString` contenant une URL.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-badge |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Notification.body
=================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`body`** de l'interface `Notification` est la chaîne de caractères qui correspond au corps de la notification, comme définis à l'aide de l'option `body` lors de la création de la notification à l'aide du constructeur `Notification()`.

Syntaxe
-------


```js
Notification.body;
```

### Valeur

Une `DOMString` contenant le corps de la notification.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-body |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.data
=================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`data`** de l'interface `Notification` renvoie un clone structuré des données de la notification, comme définis à l'aide de l'option `data` lors de la création de la notification à l'aide du constructeur `Notification()` .

Les données de la notification peuvent être des données arbitraires, sans restriction de format que vous souhaitez associer à la notification.

Syntaxe
-------


```js
Notification.data;
```

### Valeur

Un clone structuré.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-data |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.onclick
====================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété **`onclick`**, rattachée à l'interface `Notification`, définit un gestionnaire d'évènement à déclencher lorsque la notification recçoit un évènement `click` (qui se produit lorsqu'un utilisateur clique sur la notification).

Syntaxe
-------


```js
Notification.onclick = function(event) { ... };
```


Le comportement par défaut consiste à déplacer le focus sur la zone d'affichage (*viewport*) du contexte de navigation de la notification. Pour éviter ce comportement, on pourra appeler la méthode `preventDefault()` sur l'objet représentant l'évènement.

Exemples
--------

Dans l'exemple qui suit, on utilise le gestionnaire d'évènement `onclick` pour ouvrir une page dans un nouvel onglet (avec le paramètre `'_blank'`) lorsqu'on clique sur la notification :


```js
notification.onclick = function (event) {
  event.preventDefault(); // empêcher le navigateur de passer le focus sur l'onglet de la navigation
  window.open("http://www.mozilla.org", "\_blank");
};
```

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-onclick |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Notification`
* Utiliser l'API Notifications
Notification.requireInteraction
===============================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`requireInteraction`** de l'interface `Notification` renvoie un `Boolean` indiquant qu'une notification doit rester active jusqu'à ce que l'utilisateur clique dessus ou la rejette, plutôt que de se fermer automatiquement. Ceci peut être défini à l'aide de l'option `requireInteraction` lors de la création de la notification à l'aide du constructeur `Notification.Notification()`.

Syntaxe
-------


```js
Notification.requireInteraction;
```

### Valeur

Un `Boolean`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-requireinteraction |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.vibrate
====================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`vibrate`** de l'interface `Notification` spécifie un modèle de vibration que le matériel de vibration de l'appareil doit émettre lorsque la notification se déclenche. Ceci est comme définis à l'aide de l'option `vibrate` lors de la création de la notification à l'aide du constructeur `Notification ()`.

Syntaxe
-------


```js
Notification.vibrate;
```

### Valeur

Un modèle de vibration (en-US), tel que spécifié dans la spécification de l'`Api de Vibration`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-vibrate |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.maxActions
=======================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

L'attribut **`maxActions`** de l'interface `Notification` renvoie le nombre maximal d'actions prises en charge par l'appareil et l'agent utilisateur. En effet, c'est le nombre maximum d'éléments dans le tableau `Notification.actions` qui seront respectés par l'agent utilisateur.

Syntaxe
-------


```js
Notification.maxActions;
```

### Valeur

Un entier `Number` qui indique le plus grand nombre d'actions de notification pouvant être présentées à l'utilisateur par l'agent utilisateur et l'appareil.

Exemples
--------

L'extrait de code suivant enregistre le nombre maximal d'actions prises en charge.


```js
const { maxActions } = Notification;
console.log(
  `This device can display at most ${maxActions} actions on each notification.`,
);
```

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-maxactions |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
* `Notification.actions`
Notification.silent
===================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`silent`** de l'interface `Notification` spécifie si la notification doit être silencieuse, c'est-à-dire qu'aucun son ou vibration ne doit être émis, quels que soient les paramètres de l'appareil. Ceci est comme définis à l'aide de l'option `silent` lors de la création de la notification à l'aide du constructeur `Notification()`.

Syntaxe
-------


```js
Notification.silent;
```

### Valeur

Un `Boolean` (en-US). `false` est la valeur par défaut; `true` rend la notification silencieuse.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-silent |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.tag
================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`tag`** de l'interface `Notification` correspond à une balise d'identification pour la notification, comme définis à l'aide de l'option `tag` lors de la création de la notification à l'aide du constructeur `Notification()`.

L'idée des balises de notification est que plusieurs notifications peuvent partager la même balise, les reliant entre elles. Une notification peut ensuite être programmatiquement remplacée par une autre pour éviter que l'écran des utilisateurs ne soit rempli d'un grand nombre de notifications similaires.

Syntaxe
-------


```js
Notification.tag;
```

### Valeur

Une `DOMString`.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-tag |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.dir
================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`dir`** de l'interface `Notification` indique le sens du texte de la notification, définis à l'aide de l'option `dir` lors de la création de la notification à l'aide du constructeur `Notification()`.

Syntaxe
-------


```js
Notification.dir;
```

### Valeur

Une `DOMString` spécifiant la direction du texte. Les valeurs possibles sont:

* `auto`: adopte le comportement de réglage de la langue du navigateur (par défaut).
* `ltr`: de gauche à droite.
* `rtl` : de droite à gauche.

**Note :** La plupart des navigateurs semblent ignorer les paramètres explicites de ltr et rtl, et utilisent simplement le paramètre à l'échelle du navigateur.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-dir |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
Notification.actions
====================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété **`actions`** en lecture seule de l'interface `Notification` renvoie la liste des `NotificationAction` objets définis à l'aide de l'option `actions` lors de la création de la notification à l'aide du constructeur `Notification()`.

Il s'agit d'une liste des actions définies par l'application que l'utilisateur peut choisir de prendre directement depuis le contexte d'une notification.

**Note :** Le périphérique et l'agent utilisateur peuvent ne pouvoir afficher qu'un nombre limité d'actions (en raison, par exemple, d'un espace d'écran limité). Cette limite peut être déduite de `Notification.maxActions`.

Syntaxe
-------


```js
Notification.actions;
```

### Valeur

Un tableau en lecture seule d'objets `NotificationAction`, chacun décrivant une action unique que l'utilisateur peut choisir dans une notification.

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-actions |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utilisation de l'API Notifications
* `Notification.maxActions`
Notification.onerror
====================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété **`onerror`** de l'interface `Notification` spécifie un écouteur d'événements pour recevoir les événements `error`. Ces événements se produisent lorsque quelque chose ce déroule mal avec une `Notification` (dans de nombreux cas, une erreur qui empêche l'affichage de la notification.)

Syntaxe
-------


```js
Notification.onerror = function(event) { ... }
Notification.onerror = (even) => { ... }
```

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-onerror |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Notification`
* Utilisation de l'API Notifications
Notification.permission
=======================

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La propriété en lecture seule **`permission`** de l'interface `Notification` indique l'autorisation actuelle accordée par l'utilisateur à l'origine actuelle pour afficher des notifications.

Syntaxe
-------


```js
Notification.permission;
```

### Valeur

Une `DOMString` représentant l'autorisation actuelle. La valeur peut être:

* `granted`: L'utilisateur a explicitement accordé l'autorisation à l'origine actuelle d'afficher les notifications système.
* `denied`: L'utilisateur a explicitement refusé l'autorisation pour l'origine actuelle d'afficher les notifications système.
* `default`: La décision de l'utilisateur est inconnue; dans ce cas, l'application agira comme si l'autorisation était `denied`.
Exemples
--------

L'extrait suivant peut être utilisé si vous souhaitez d'abord vérifier si les notifications sont prises en charge, puis vérifier si l'autorisation a été accordée pour l'origine actuelle pour envoyer des notifications, puis demander l'autorisation si nécessaire, avant d'envoyer une notification.


```js
function notifyMe() {
  // Let's check if the browser supports notifications
  if (!("Notification" in window)) {
    console.log("This browser does not support desktop notification");
  }

  // Let's check whether notification permissions have alredy been granted
  else if (Notification.permission === "granted") {
    // If it's okay let's create a notification
    const notification = new Notification("Hi there!");
  }

  // Otherwise, we need to ask the user for permission
  else if (
    Notification.permission !== "denied" ||
    Notification.permission === "default"
  ) {
    Notification.requestPermission((permission) => {
      // If the user accepts, let's create a notification
      if (permission === "granted") {
        const notification = new Notification("Hi there!");
      }
    });
  }

  // At last, if the user has denied notifications, and you
  // want to be respectful there is no need to bother them any more.
}
```

Spécifications
--------------

| Specification |
| --- |
| Notifications API Standard # dom-notification-permission |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* API de notifications
* Utilisation de l'API Notifications
* Permissions d'API
* Utilisation des permissions d'API (en-US)