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 der Notification
Schnittstelle wird verwendet, um eine zuvor angezeigte Benachrichtigung zu schließen/entfernen.
Hinweis: Diese API sollte nicht verwendet werden, um die Benachrichtigung einfach nach einer festen Verzögerung vom Bildschirm zu entfernen, da diese Methode die Benachrichtigung auch aus jedem Benachrichtigungsfeld entfernt, wodurch Benutzer daran gehindert werden, nach der ersten Anzeige mit ihr zu interagieren. Eine gültige Verwendung dieser API wäre das Entfernen einer Benachrichtigung, die nicht mehr relevant ist (z.B. der Benutzer hat die Benachrichtigung bereits auf der Webseite in einem Messaging-App gelesen oder das nächste Lied wird bereits in einer Musik-App abgespielt).
Syntax
close()
Parameter
Keine.
Rückgabewert
Keiner (undefined
).
Beispiele
Im folgenden Code-Schnipsel haben wir eine Funktion, die beim Aufruf ein options
Objekt erstellt und dann eine neue Benachrichtigung. Am Ende der Funktion wird close()
innerhalb einer addEventListener()
Funktion aufgerufen, um die Benachrichtigung zu entfernen, wenn die relevanten Inhalte auf der Webseite gelesen wurden.
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