Notification: close()-Methode
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die close()
-Methode des Notification
-Interfaces wird verwendet, um eine zuvor angezeigte Benachrichtigung zu schließen oder zu entfernen.
Hinweis: Diese API sollte nicht verwendet werden, um die Benachrichtigung nach einer festen Verzögerung vom Bildschirm zu entfernen, da diese Methode auch die Benachrichtigung aus jedem Benachrichtigungsbereich entfernt. Dies hindert die Benutzer daran, nach dem ersten Anzeigen damit zu interagieren. Eine valide Verwendung dieser API wäre, eine Benachrichtigung zu entfernen, die nicht mehr relevant ist (z.B. der Nutzer hat die Benachrichtigung bereits auf der Webseite gelesen im Fall einer Messaging-App oder der folgende Song wird bereits in einer Musik-App abgespielt).
Syntax
close()
Parameter
Keine.
Rückgabewert
Keine (undefined
).
Beispiele
Im folgenden Beispiel haben wir eine einfache Funktion, die beim Aufruf ein options
-Objekt erstellt und dann eine neue Benachrichtigung. Am Ende der Funktion wird auch close()
innerhalb einer addEventListener()
-Funktion aufgerufen, um die Benachrichtigung zu entfernen, wenn der relevante Inhalt auf der Webseite gelesen wurde.
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();
}
});
}
Spezifikationen
Specification |
---|
Notifications API Standard # dom-notification-close |
Browser-Kompatibilität
BCD tables only load in the browser