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

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.