Benachrichtigung: close() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die close() Methode des Notification-Interfaces wird verwendet, um eine zuvor angezeigte Benachrichtigung zu schließen oder zu entfernen.
Hinweis: Diese API sollte nicht nur verwendet werden, um die Benachrichtigung nach einer festgelegten Verzögerung vom Bildschirm zu entfernen, da diese Methode die Benachrichtigung auch aus jeglichen Benachrichtigungsfeldern entfernt und die Interaktion der Benutzer damit verhindert, nachdem sie ursprünglich angezeigt wurde. Eine gültige Verwendung für diese API wäre das Entfernen einer Benachrichtigung, die nicht mehr relevant ist (z.B., der Benutzer hat die Benachrichtigung bereits auf der Webseite gelesen, im Falle einer Messaging-App, oder der nächste Song wird bereits in einer Musik-App abgespielt).
Syntax
close()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Beispiele
Im folgenden Codeausschnitt haben wir eine Funktion, die beim Aufruf ein options-Objekt erstellt und dann eine neue Benachrichtigung. Am Ende der Funktion wird close() in einer addEventListener()-Funktion aufgerufen, um die Benachrichtigung zu entfernen, nachdem 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 # dom-notification-close |