Benachrichtigung - Web-APIs | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Benachrichtigung

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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.

Das Notification-Interface der Notifications API wird verwendet, um Desktop-Benachrichtigungen für den Benutzer zu konfigurieren und anzuzeigen.

Das Erscheinungsbild und die spezifische Funktionalität dieser Benachrichtigungen variieren je nach Plattform, bieten jedoch im Allgemeinen eine Möglichkeit, dem Benutzer asynchron Informationen bereitzustellen.

EventTarget Notification

In diesem Artikel

Konstruktor

Notification()

Erstellt eine neue Instanz des Notification-Objekts.

Statische Eigenschaften

Erbt auch Eigenschaften von seinem übergeordneten Interface, EventTarget.

Notification.permission Schreibgeschützt

Ein String, der die aktuelle Berechtigung zum Anzeigen von Benachrichtigungen darstellt. Mögliche Werte sind:

denied — Der Benutzer lehnt es ab, Benachrichtigungen anzeigen zu lassen.
granted — Der Benutzer akzeptiert es, Benachrichtigungen anzeigen zu lassen.
default — Die Wahl des Benutzers ist unbekannt, daher wird der Browser so handeln, als wäre der Wert denied.

Notification.maxActions Schreibgeschützt

Die maximale Anzahl von Aktionen, die vom Gerät und dem User Agent unterstützt werden.

Instanzeigenschaften

Erbt auch Eigenschaften von seinem übergeordneten Interface, EventTarget.

Notification.actions Schreibgeschützt

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

Notification.badge Schreibgeschützt

Ein String, der die URL eines Bildes enthält, um die Benachrichtigung darzustellen, wenn nicht genügend Platz vorhanden ist, um die Benachrichtigung selbst anzuzeigen, wie zum Beispiel in der Android-Benachrichtigungsleiste. Auf Android-Geräten sollte das Abzeichen Geräte bis zu einer 4-fachen Auflösung unterstützen, etwa 96 x 96 px, und das Bild wird automatisch maskiert.

Notification.body Schreibgeschützt

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

Notification.data Schreibgeschützt

Gibt eine strukturierte Kopie der Daten der Benachrichtigung zurück.

Notification.dir Schreibgeschützt

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

Notification.icon Schreibgeschützt

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

Notification.image Schreibgeschützt

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

Notification.lang Schreibgeschützt

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

Notification.navigate Schreibgeschützt

Die Navigations-URL der Benachrichtigung. Wenn festgelegt, führt das Aktivieren der Benachrichtigung zu dieser URL, anstatt das click oder notificationclick-Ereignis auszulösen.

Notification.renotify Schreibgeschützt

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

Notification.requireInteraction Schreibgeschützt

Ein boolescher Wert, der angibt, dass eine Benachrichtigung aktiv bleiben sollte, bis der Benutzer sie anklickt oder schließt, anstatt sich automatisch zu schließen.

Notification.silent Schreibgeschützt

Gibt an, ob die Benachrichtigung stumm sein soll — d.h. es sollten unabhängig von den Einstellungen des Geräts keine Geräusche oder Vibrationen ausgelöst werden.

Notification.tag Schreibgeschützt

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

Notification.timestamp Schreibgeschützt

Gibt die Uhrzeit an, zu der eine Benachrichtigung erstellt oder anwendbar ist (Vergangenheit, Gegenwart oder Zukunft).

Notification.title Schreibgeschützt

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

Notification.vibrate Schreibgeschützt

Gibt ein Vibrationsmuster für Geräte mit Vibrationshardware an, die emittiert werden soll.

Statische Methoden

Erbt auch Methoden von seinem übergeordneten Interface, EventTarget.

Notification.requestPermission()

Fordert die Erlaubnis des Benutzers an, Benachrichtigungen anzuzeigen.

Instanzmethoden

Erbt auch Methoden von seinem übergeordneten Interface, EventTarget.

Notification.close()

Schließt programmgesteuert eine Benachrichtigungsinstanz.

Ereignisse

Erbt auch Ereignisse von seinem übergeordneten Interface, EventTarget.

click

Wird ausgelöst, wenn der Benutzer auf die Benachrichtigung klickt.

Wird ausgelöst, wenn der Benutzer die Benachrichtigung schließt.

error

Wird ausgelöst, wenn die Benachrichtigung auf einen Fehler stößt.

show

Wird ausgelöst, wenn die Benachrichtigung angezeigt wird.

Beispiele

Angenommen, dieses grundlegende HTML:

html

<button>Notify me!</button>

Es ist möglich, eine Benachrichtigung wie folgt zu senden — hier präsentieren wir einen recht ausführlichen und vollständigen Code, den Sie verwenden könnten, wenn Sie zuerst überprüfen möchten, ob Benachrichtigungen unterstützt werden, dann prüfen, ob die Erlaubnis erteilt wurde, dass der aktuelle Ursprung Benachrichtigungen senden darf, dann die Erlaubnis anfordern, falls erforderlich, bevor Sie dann eine Benachrichtigung senden.

js
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 Benachrichtigungsberechtigungen von Cross-Origin <iframe>s angefordert werden, und andere Browser folgen werden. Um ein Beispiel in Aktion zu sehen, sehen Sie sich unser To-do-Liste-Beispiel an (siehe auch die laufende App).

Hinweis: Im obigen Beispiel erzeugen wir Benachrichtigungen als Reaktion auf eine Benutzeraktion (Klicken auf einen Button). Dies ist nicht nur Best Practice – Sie sollten Benutzer nicht mit Benachrichtigungen spammen, denen sie nicht zugestimmt haben – sondern Browser werden künftig ausdrücklich Benachrichtigungen verbieten, die nicht als Reaktion auf eine Benutzeraktion ausgelöst werden. Firefox tut dies bereits ab Version 72.

Verwendung der Notifications API

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Notifications API
Benachrichtigung
Konstruktor
1. Notification()
Statische Eigenschaften
1. maxActions
2. permission
Instanzeigenschaften
Statische Methoden
1. requestPermission()
Instanzmethoden
1. close()
Events
Vererbung
1. EventTarget
Verwandte Seiten für Web Notifications
Anleitungen
1. Verwendung der Notifications API