notifications.clear()

清除给定 ID 的通知。

这是一个返回 Promise 的异步函数。

语法

let clearing = browser.notifications.clear(
  id                            // 字符串
)

参数

id: string，要清除的通知 ID。这与传递给 notifications.create() 的回调函数的 ID 相同。

返回值

Promise，将会用一个布尔值兑现：如果通知被清除，则为 true，否则为 false（例如 id 所指代的通知不存在）。

浏览器兼容性

BCD tables only load in the browser

示例

下述示例在用户点击浏览器操作时显示一个通知（如果通知已经在显示了则会清除这一通知）：

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: "一段标题",
      message: "一些有意思的内容文本",
    });
  }
}

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

browser.browserAction.onClicked.addListener(handleClick);