W3cubDocs

/Web Extensions

browserSettings.webNotificationsDisabled

A BrowserSetting object that can be used to prevent websites from showing notifications using the Notifications Web API.

The Notifications API is used to display desktop notifications to the user. There are three levels of permission for notifications: allow, deny, and prompt. Users can set this permission for every site. If the user has not set a permission for a particular site, then the browser will fall back to a global permission, which defaults to prompt.

Setting browserSettings.webNotificationsDisabled to true switches the global permission to deny.

Note that this won't affect sites for which the user has set a per-site preference. For example, if the user sets https://example.org to allow, and an extension then sets browserSettings.webNotificationsDisabled to true, then pages under https://example.org will still be allowed to show notifications.

Setting browserSettings.webNotificationsDisabled to false switches the global default back to its default value.

Note that this setting has no effect on notifications created by extensions using the notifications API.

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
webNotificationsDisabled
No
No
58
?
No
No
?
?
58
?
?
?

Examples

Toggle the setting:

async function toggleWebNotifications() {
  let current = await browser.browserSettings.webNotificationsDisabled.get({});
  console.log(`Current value: ${current.value}`);
  browser.browserSettings.webNotificationsDisabled.set({value: !current.value});
}

browser.browserAction.onClicked.addListener(() => {
  toggleWebNotifications();
});

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserSettings/webNotificationsDisabled