Notification.close()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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
| Specification |
|---|
| Notifications API Standard # dom-notification-close |
Compatibilité des navigateurs
BCD tables only load in the browser