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. Diese entspricht der ID, die im Rückruf von notifications.create() übergeben wurde.

Rückgabewert

Ein Promise, das mit einem booleschen Wert erfüllt wird: true, wenn die Benachrichtigung gelöscht wurde, oder false, wenn sie nicht gelöscht wurde (zum Beispiel, weil die Benachrichtigung, auf die durch id verwiesen wird, nicht existierte).

Beispiele

Dieses Beispiel zeigt eine Benachrichtigung, wenn der Benutzer eine Browser-Aktion anklickt, es sei denn, die Benachrichtigung wurde 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);

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.notifications API.