notifications.clear()

Löscht eine Benachrichtigung anhand ihrer ID.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let clearing = browser.notifications.clear(
  id                            // string
)

Parameter

id

string. Die ID der zu löschenden Benachrichtigung. Dies ist dieselbe ID, die im Callback von notifications.create() übergeben wird.

Rückgabewert

Ein Promise, das mit einem boolean erfüllt wird: true, wenn die Benachrichtigung gelöscht wurde, oder false, wenn dies nicht der Fall war (zum Beispiel, weil die durch id referenzierte Benachrichtigung nicht existierte).

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
clear

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Beispiele

Dieses Beispiel zeigt eine Benachrichtigung, wenn der Benutzer auf eine Browseraktion klickt, es sei denn, die Benachrichtigung wird bereits angezeigt, in diesem Fall wird die Benachrichtigung gelöscht:

js
let myNotification = "my-notification";

function toggleAlarm(all) {
  if (myNotification in all) {
    browser.notifications.clear(myNotification);
  } else {
    browser.notifications.create(myNotification, {
      type: "basic",
      iconUrl: browser.runtime.getURL("icons/cake-48.png"),
      title: "Am imposing title",
      message: "Some interesting content",
    });
  }
}

function handleClick() {
  let gettingAll = browser.notifications.getAll();
  gettingAll.then(toggleAlarm);
}

browser.browserAction.onClicked.addListener(handleClick);

Hinweis: Diese API basiert auf der chrome.notifications-API von Chromium.