notifications.update()

更新给定 ID 的通知。

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

语法

let updating = browser.notifications.update(
  id,                            // 字符串
  options                        // NotificationOptions
)

参数

id: string。要更新的通知的 ID。与传递给 notifications.create() 的回调函数的 ID 相同。
options: notifications.NotificationOptions，定义通知的新内容和新行为。

返回值

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

浏览器兼容性

BCD tables only load in the browser

示例

这个示例使用 update() 来更新一个进度通知。点击浏览器操作按钮会显示通知并启动一个 alarm。我们将使用它来更新通知的进度指示器。

请注意，你需要“alarms”权限来创建闹钟（以及“notifications”权限来创建通知）。还请注意，Firefox 不支持 progress 属性。

let cakeNotification = "cake-notification";

/*

在本例中，CAKE_INTERVAL 被设定为 0.3 秒。我们选定这一较短的时间是为了使扩展的行为更加明显，但在实际应用中不推荐这样做。
请注意，在 Chrome 中，无法设置小于一分钟的定时器。

*/
let CAKE_PREP_INTERVAL = 0.005;

let progress = 0;

browser.alarms.onAlarm.addListener((alarm) => {
  progress += 10;
  if (progress > 100) {
    browser.notifications.clear(cakeNotification);
    browser.alarms.clear("cake-progress");
  } else {
    browser.notifications.update(cakeNotification, { progress });
  }
});

browser.browserAction.onClicked.addListener(() => {
  browser.notifications.getAll((all) => {
    if (all.length > 0) {
      browser.notifications.clear(cakeNotification);
      return;
    }
    progress = 0;
    browser.notifications.create(cakeNotification, {
      type: "progress",
      iconUrl: browser.extension.getURL("icons/cake-48.png"),
      title: "正在准备你的蛋糕……",
      message: "一些蛋糕",
      progress,
    });
    browser.alarms.create("cake-progress", {
      periodInMinutes: CAKE_PREP_INTERVAL,
    });
  });
});