Notification: silent-Eigenschaft

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 schreibgeschützte silent-Eigenschaft des Notification-Interfaces gibt an, ob die Benachrichtigung stumm sein soll, d.h. keine Geräusche oder Vibrationen sollten ausgegeben werden, unabhängig von den Geräteeinstellungen. Dies wird über die silent-Option des Notification()-Konstruktors gesteuert.

Wert

Ein boolescher Wert oder null. Wenn auf true gesetzt, ist die Benachrichtigung stumm; wenn auf null gesetzt (der Standardwert), werden die Standardeinstellungen des Geräts respektiert.

Beispiele

Das folgende Beispiel löst eine stumme Benachrichtigung aus. Ein options-Objekt wird erstellt, und die Benachrichtigung wird als Reaktion auf einen Button-Klick unter Verwendung des Notification()-Konstruktors ausgelöst. Der Code umfasst auch eine rudimentäre Berechtigungsbehandlung, die die Erlaubnis des Nutzers anfordert, Benachrichtigungen auszulösen, falls diese noch nicht erteilt wurde.

js
const btn = document.querySelector("button");

const options = {
  body: "No annoying pings or vibrations?",
  silent: true,
};

function requestSilentNotification() {
  const n = new Notification("Silent notification", options);
  console.log(n.silent); // should return true
}

btn.addEventListener("click", () => {
  if (Notification.permission === "granted") {
    requestSilentNotification();
  } else {
    Notification.requestPermission().then((permission) => {
      if (permission === "granted") {
        requestSilentNotification();
      } else {
        console.log("Notification permission was not granted");
      }
    });
  }
});

Spezifikationen

Specification
Notifications API Standard
# dom-notification-silent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch