此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

notifications.clear()

清除给定 ID 的通知。

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

语法

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

参数

id

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

返回值

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

浏览器兼容性

示例

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

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: "一段标题", message: "一些有意思的内容文本", }); } } function handleClick() { let gettingAll = browser.notifications.getAll(); gettingAll.then(toggleAlarm); } browser.browserAction.onClicked.addListener(handleClick); 

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