browserSettings.webNotificationsDisabled

Ein BrowserSetting-Objekt, das verwendet werden kann, um zu verhindern, dass Websites Benachrichtigungen über die Notifications Web-API anzeigen.

Die Notifications-API wird verwendet, um Desktop-Benachrichtigungen an den Benutzer anzuzeigen. Es gibt drei Berechtigungsstufen für Benachrichtigungen: allow, deny und prompt. Benutzer können diese Berechtigung für jede Website festlegen. Wenn der Benutzer für eine bestimmte Website keine Berechtigung festgelegt hat, greift der Browser auf eine globale Berechtigung zurück, die standardmäßig auf prompt eingestellt ist.

Wenn browserSettings.webNotificationsDisabled auf true gesetzt wird, wechselt die globale Berechtigung zu deny.

Beachten Sie, dass dies keine Auswirkungen auf Websites hat, für die der Benutzer eine standortspezifische Präferenz festgelegt hat. Wenn der Benutzer beispielsweise https://example.org auf allow setzt und eine Erweiterung dann browserSettings.webNotificationsDisabled auf true setzt, dann sind Seiten unter https://example.org weiterhin berechtigt, Benachrichtigungen anzuzeigen.

Wenn browserSettings.webNotificationsDisabled auf false gesetzt wird, wechselt der globale Standard wieder zu seinem Standardwert zurück.

Beachten Sie, dass diese Einstellung keine Auswirkungen auf Benachrichtigungen hat, die von Erweiterungen mithilfe der notifications API erstellt wurden.

Browser-Kompatibilität

Beispiele

Einstellung umschalten:

js
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();
});