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 nach einer festen Verzögerung vom Bildschirm zu entfernen, da diese Methode auch die Benachrichtigung aus jeglicher Benachrichtigungsleiste entfernt, wodurch Benutzer nicht mehr mit ihr interagieren können, nachdem sie ursprünglich angezeigt wurde. Ein gültiger Anwendungsfall für diese API wäre, eine Benachrichtigung zu entfernen, die nicht mehr relevant ist (z. B. wenn der Benutzer die Benachrichtigung auf der Webseite bereits gelesen hat, im Fall einer Messaging-App, oder der nächste Song bereits in einer Musik-App abgespielt wird).
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 erzeugt. Am Ende der Funktion wird 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 # dom-notification-close |
Browser-Kompatibilität
Loading…