notifications.clear()

清除一个通知,给定其 ID。

这是一个异步函数,返回一个 Promise

语法

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

参数

id

string。要清除的通知的 ID。这与在 notifications.create() 的回调中传递的 ID 相同。

返回值

一个 Promise,它将以布尔值 fulfilled:如果通知已被清除,则为 true;如果未被清除(例如,因为 id 引用的通知不存在),则为 false

示例

此示例显示当用户点击浏览器操作时一个通知,除非该通知已在显示,在这种情况下它会清除该通知。

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);

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.notifications API。