Notification: silent property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The silent read-only property of the Notification interface specifies whether the notification should be silent, i.e., no sounds or vibrations should be issued regardless of the device settings. This is controlled via the silent option of the Notification() constructor.

Value

A boolean value or null. If set to true, the notification is silent; if set to null (the default value), the device's default settings are respected.

Examples

The following snippet fires a silent notification. An options object is created, and the notification is fired in response to a button click using the Notification() constructor. The code also includes rudimentary permissions handling, requesting permission from the user to fire notifications if it has not already been granted.

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");
      }
    });
  }
});

Specifications

Specification
Notifications API Standard
# dom-notification-silent

Browser compatibility

BCD tables only load in the browser

See also