Notification: silent property
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.
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