Limited availability
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.
Der Notification()-Konstruktor erstellt eine neue Instanz des Notification-Objekts, das eine Benutzerbenachrichtigung darstellt.
Hinweis: Wenn Sie versuchen, innerhalb des ServiceWorkerGlobalScope mit dem Notification()-Konstruktor eine Benachrichtigung zu erstellen, wird ein TypeError ausgelöst. Verwenden Sie stattdessen ServiceWorkerRegistration.showNotification().
new Notification(title)
new Notification(title, options)
title
Definiert einen Titel für die Benachrichtigung, der oben im Benachrichtigungsfenster angezeigt wird.
options Optional
Ein Optionsobjekt, das benutzerdefinierte Einstellungen enthält, die Sie auf die Benachrichtigung anwenden möchten. Die möglichen Optionen sind:
actions Optional
Muss nicht angegeben oder ein leeres Array sein. actions wird nur für persistente Benachrichtigungen unterstützt, die von einem Service Worker mit ServiceWorkerRegistration.showNotification() ausgelöst werden.
badge Optional
Ein String, der die URL des Bildes enthält, das verwendet wird, um die Benachrichtigung darzustellen, wenn nicht genug Platz vorhanden ist, um die Benachrichtigung selbst anzuzeigen; zum Beispiel in der Android-Benachrichtigungsleiste. Auf Android-Geräten sollte das Badge für Geräte bis zu einer 4-fachen Auflösung, etwa 96x96px, ausgelegt sein, und das Bild wird automatisch maskiert.
body Optional
Ein String, der den Textinhalt der Benachrichtigung darstellt, der unterhalb des Titels angezeigt wird. Der Standardwert ist der leere String.
data Optional
Beliebige Daten, die Sie mit der Benachrichtigung verknüpfen möchten. Diese können von jedem struktur-klonbaren Datentyp sein. Der Standardwert ist null.
dir Optional
Die Richtung, in der die Benachrichtigung angezeigt werden soll. StandardmäÃig auto, was einfach das Sprachverhalten des Browsers übernimmt, aber Sie können dieses Verhalten mit den Werten ltr und rtl überschreiben (obwohl die meisten Browser diese Einstellungen zu ignorieren scheinen).
icon Optional
Ein String, der die URL eines Symbols enthält, das in der Benachrichtigung angezeigt wird.
image Optional
Ein String, der die URL eines Bildes enthält, das in der Benachrichtigung angezeigt wird.
lang Optional
Die Sprache der Benachrichtigung, angegeben als String, der ein Sprach-Tag gemäà RFC 5646: Tags for Identifying Languages (auch bekannt als BCP 47) darstellt. Siehe die Sitepoint ISO 2-Buchstaben Sprachcodes Seite als einfache Referenz. Der Standardwert ist der leere String.
renotify Optional
Ein boolescher Wert, der angibt, ob der Benutzer benachrichtigt werden soll, nachdem eine neue Benachrichtigung eine alte ersetzt hat. Der Standardwert ist false, was bedeutet, dass sie nicht benachrichtigt werden. Wenn true, muss auch tag gesetzt sein.
requireInteraction Optional
Gibt an, dass eine Benachrichtigung aktiv bleiben sollte, bis der Benutzer sie klickt oder verwirft, anstatt automatisch zu schlieÃen. Der Standardwert ist false.
silent Optional
Ein boolescher Wert, der angibt, ob die Benachrichtigung stummgeschaltet sein soll, d.h. es sollten keine Geräusche oder Vibrationen ausgegeben werden, unabhängig von den Geräteeinstellungen. Wenn auf true gesetzt, ist die Benachrichtigung stumm; wenn auf null (der Standardwert) gesetzt, werden die Standardeinstellungen des Geräts beachtet.
tag Optional
Ein String, der ein identifizierendes Tag für die Benachrichtigung darstellt. Der Standardwert ist der leere String.
timestamp Optional
Ein Zeitstempel, angegeben als Unix-Zeit in Millisekunden, der die Zeit darstellt, die mit der Benachrichtigung verbunden ist. Dies kann in der Vergangenheit liegen, wenn eine Benachrichtigung für eine Nachricht verwendet wird, die nicht sofort zugestellt werden konnte, weil das Gerät offline war, oder in der Zukunft für ein bevorstehendes Meeting.
vibrate Optional
Ein Vibrationsmuster für die Vibrationshardware des Geräts, das mit der Benachrichtigung ausgegeben werden soll. Wenn angegeben, darf silent nicht true sein.
Eine Instanz des Notification-Objekts.
TypeError
Ausgelöst, wenn:
ServiceWorkerGlobalScope aufgerufen wird.actions angegeben und nicht leer ist.silent true ist und die Option vibrate angegeben ist.renotify true ist, aber die Option tag leer ist.DataCloneError DOMException
Ausgelöst, wenn das Serialisieren der data-Option aus irgendeinem Grund fehlschlug.
Hier ist ein einfaches Beispiel, um nur eine Benachrichtigung anzuzeigen, wenn die Erlaubnis bereits gewährt wurde. Für vollständigere Beispiele siehe die Notification-Seite.
if (Notification.permission === "granted") {
const notification = new Notification("Hi there!");
}
Ab Chrome 49 funktionieren Benachrichtigungen nicht im Inkognitomodus.
Chrome für Android wird einen TypeError auslösen, wenn der Notification-Konstruktor aufgerufen wird. Es unterstützt nur die Erstellung von Benachrichtigungen aus einem Service Worker. Weitere Details finden Sie im Chromium Issue Tracker.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4