Benachrichtigung

Konstruktor

Notification()

Erstellt eine neue Instanz des Notification Objekts.

Statische Eigenschaften

Erbt auch Eigenschaften von seinem bergeordneten Interface, EventTarget.

Notification.permission Schreibgeschtzt

Ein String, der die aktuelle Berechtigung zur Anzeige von Benachrichtigungen darstellt. Mgliche Werte sind:

• denied Der Benutzer lehnt es ab, Benachrichtigungen anzuzeigen.
• granted Der Benutzer akzeptiert die Anzeige von Benachrichtigungen.
• default Die Wahl des Benutzers ist unbekannt, daher wird der Browser so handeln, als wre der Wert abgelehnt.

Notification.maxActions Schreibgeschtzt

Die maximale Anzahl von Aktionen, die von dem Gert und dem User Agent untersttzt werden.

Instanzeigenschaften

Erbt auch Eigenschaften von seinem bergeordneten Interface, EventTarget.

Notification.actions Schreibgeschtzt

Das Aktionsarray der Benachrichtigung, wie im options Parameter des Konstruktors angegeben.

Notification.badge Schreibgeschtzt

Ein String, der die URL eines Bildes enthlt, das die Benachrichtigung darstellt, wenn nicht genug Platz vorhanden ist, um die Benachrichtigung selbst anzuzeigen, wie z. B. in der Android-Benachrichtigungsleiste. Auf Android-Gerten sollte das Abzeichen Gerte bis zu einer Auflsung von 4x, etwa 96 x 96 px, untersttzen, und das Bild wird automatisch maskiert.

Notification.body Schreibgeschtzt

Der Textkrper der Benachrichtigung, wie im options Parameter des Konstruktors angegeben.

Notification.data Schreibgeschtzt

Gibt einen strukturierten Klon der Daten der Benachrichtigung zurck.

Notification.dir Schreibgeschtzt

Die Textausrichtung der Benachrichtigung, wie im options Parameter des Konstruktors angegeben.

Notification.icon Schreibgeschtzt

Die URL des Bildes, das als Symbol der Benachrichtigung verwendet wird, wie im options Parameter des Konstruktors angegeben.

Notification.image Schreibgeschtzt

Die URL eines Bildes, das als Teil der Benachrichtigung angezeigt werden soll, wie im options Parameter des Konstruktors angegeben.

Notification.lang Schreibgeschtzt

Der Sprachcode der Benachrichtigung, wie im options Parameter des Konstruktors angegeben.

Notification.navigate Schreibgeschtzt

Die Navigations-URL der Benachrichtigung. Wenn sie gesetzt ist, navigiert die Aktivierung der Benachrichtigung zu dieser URL, anstatt das click oder notificationclick Ereignis auszulsen.

Notification.renotify Schreibgeschtzt

Gibt an, ob der Benutzer benachrichtigt werden sollte, nachdem eine neue Benachrichtigung eine alte ersetzt hat.

Notification.requireInteraction Schreibgeschtzt

Ein boolescher Wert, der angibt, dass eine Benachrichtigung aktiv bleiben sollte, bis der Benutzer sie anklickt oder verwirft, anstatt sich automatisch zu schlieen.

Notification.silent Schreibgeschtzt

Gibt an, ob die Benachrichtigung lautlos sein soll d.h. es sollten keine Tne oder Vibrationen ausgegeben werden, unabhngig von den Gerteeinstellungen.

Notification.tag Schreibgeschtzt

Die ID der Benachrichtigung (falls vorhanden), wie im options Parameter des Konstruktors angegeben.

Notification.timestamp Schreibgeschtzt

Gibt die Zeit an, zu der eine Benachrichtigung erstellt oder anwendbar ist (vergangen, gegenwrtig oder zuknftig).

Notification.title Schreibgeschtzt

Der Titel der Benachrichtigung, wie im ersten Parameter des Konstruktors angegeben.

Notification.vibrate Schreibgeschtzt

Gibt ein Vibrationsmuster an, das von Gerten mit Vibrationshardware ausgegeben werden soll.

Statische Methoden

Erbt auch Methoden von seinem bergeordneten Interface, EventTarget.

Notification.requestPermission()

Fordert die Berechtigung vom Benutzer an, um Benachrichtigungen anzuzeigen.

Instanzmethoden

Erbt auch Methoden von seinem bergeordneten Interface, EventTarget.

Notification.close()

Schliet eine Benachrichtigungsinstanz programmgesteuert.

Ereignisse

Erbt auch Ereignisse von seinem bergeordneten Interface, EventTarget.

click

Wird ausgelst, wenn der Benutzer die Benachrichtigung anklickt.

close

Wird ausgelst, wenn der Benutzer die Benachrichtigung schliet.

error

Wird ausgelst, wenn die Benachrichtigung auf einen Fehler stt.

show

Wird ausgelst, wenn die Benachrichtigung angezeigt wird.

Beispiele

Angenommen, dieses grundlegende HTML:

<button>Notify me!</button>

Es ist mglich, eine Benachrichtigung wie folgt zu senden hier prsentieren wir einen ziemlich ausfhrlichen und umfassenden Code, den Sie verwenden knnten, wenn Sie zuerst berprfen mchten, ob Benachrichtigungen untersttzt werden, dann berprfen, ob die Erlaubnis erteilt wurde, Benachrichtigungen vom aktuellen Ursprung zu senden, dann bei Bedarf die Erlaubnis anfordern und schlielich eine Benachrichtigung senden.

document.querySelector("button").addEventListener("click", notifyMe);

function notifyMe() {
  if (!("Notification" in window)) {
    // Check if the browser supports notifications
    alert("This browser does not support desktop notification");
  } else if (Notification.permission === "granted") {
    // Check whether notification permissions have already been granted;
    // if so, create a notification
    const notification = new Notification("Hi there!");
    // 
  } else if (Notification.permission !== "denied") {
    // We need to ask the user for permission
    Notification.requestPermission().then((permission) => {
      // If the user accepts, let's create a notification
      if (permission === "granted") {
        const notification = new Notification("Hi there!");
        // 
      }
    });
  }

  // At last, if the user has denied notifications, and you
  // want to be respectful there is no need to bother them anymore.
}

Wir zeigen kein Live-Beispiel mehr auf dieser Seite, da Chrome und Firefox nicht mehr erlauben, dass Berechtigungen fr Benachrichtigungen von Cross-Origin <iframe>s angefordert werden, andere Browser folgen. Um ein Beispiel in Aktion zu sehen, schauen Sie sich unser To-do-Listenbeispiel (siehe auch die App luft live).

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Verwendung der Notifications API