Notification.close()

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 méthode close() de l'interface Notification est utilisée pour fermer / supprimer une notification précédemment affichée.

Note: Cette API ne doit pas être utilisée uniquement pour supprimer la notification de l'écran après un délai fixe, car cette méthode supprimera également la notification de toute barre de notification, empêchant ainsi les utilisateurs d'interagir avec elle après son affichage initial. Une utilisation valable de cette API serait de supprimer une notification qui n'est plus pertinente (par exemple, l'utilisateur a déjà lu la notification sur la page Web dans le cas d'une application de messagerie ou la chanson suivante est déjà en cours de lecture dans une application musicale).

Syntaxe

Notification.close()

Paramètres

Aucun.

Returns

Void.

Exemples

Dans l'extrait de code suivant, nous avons une simple fonction qui, lorsqu'elle est appelée, crée un objet options, puis de celui-ci une nouvelle notification. À la fin de la fonction, elle appelle également close() dans une fonction addEventListener () pour supprimer la notification lorsque le contenu pertinent a été lu sur la page Web.

function spawnNotification(theBody, theIcon, theTitle) {
  const options = {
    body: theBody,
    icon: theIcon
  }

  const n = new Notification(theTitle, options)
  document.addEventListener('visibilitychange', () => {
    if (document.visibilityState === 'visible') {
      // The tab has become visible so clear the now-stale Notification.
      n.close()
    }
  })
}

Spécifications

Spécification Status Comment
Notifications API Standard évolutif Living standard

Compatibilité des navigateurs

BCD tables only load in the browser

Voir également