notifications.create()
创建并显示一条通知。
你可以传递 notifications.NotificationOptions 来定义通知的内容和行为。
你也可以为通知提供一个可选的 ID。如果省略 ID,则浏览器将为其生成一个 ID。你可以使用 ID 来更新或清除通知。
这是一个返回 Promise 的异步函数。
警告:如果你在短时间内多次调用 notifications.create(),Firefox 可能最终不会显示任何通知。
语法
js
let creating = browser.notifications.create( id, // 可选的字符串 options // NotificationOptions ) 参数
id可选-
string,用于在notifications.update()、notifications.clear()和事件监听器中指代此通知的标识符。如果省略此参数或传递空字符串,则浏览器将为此通知生成一个新的 ID。如果提供的 ID 与此扩展的现有通知的 ID 匹配,则将清除另一个通知。 options-
notifications.NotificationOptions。定义通知的内容和行为。
返回值
Promise,在通知被创建以及显示进程开始之后(在通知实际显示给用户之前)兑现为一个代表通知 ID 的字符串。
示例
下述示例使用 alarm 定期显示通知。点击浏览器操作会关闭通知。你需要“alarms”权限创建定时器(以及“notifications”权限来创建通知)。
js
let cakeNotification = "cake-notification"; /* 在本例中,CAKE_INTERVAL 被设定为 6 秒。我们选定这一较短的时间是为了使扩展的行为更加明显,但在实际应用中不推荐这样做。 请注意,在 Chrome 中,无法设置小于一分钟的定时器。 */ let CAKE_INTERVAL = 0.1; browser.alarms.create("", { periodInMinutes: CAKE_INTERVAL }); browser.alarms.onAlarm.addListener((alarm) => { browser.notifications.create(cakeNotification, { type: "basic", iconUrl: browser.runtime.getURL("icons/cake-96.png"), title: "是时候吃蛋糕了!", message: "一些有意思的蛋糕", }); }); browser.browserAction.onClicked.addListener(() => { const clearing = browser.notifications.clear(cakeNotification); clearing.then(() => { console.log("通知已被清除"); }); }); 示例扩展
浏览器兼容性
备注:此 API 基于 Chromium 的 chrome.notifications API。