notifications.clear()

清除给定 ID 的通知。

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

语法

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

参数

id

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

返回值

一个 Promise，它将使用布尔值来实现：如果通知已清除，则为 true；如果未清除（例如，因为 id 引用的通知不存在），则为 false。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

此示例显示在用户单击浏览器操作时弹出的通知，除非通知已在显示，在这种情况下它会清除通知

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。