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

BCD tables only load in the browser

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.