notifications.update()
Updates a notification, given its ID.
This is an asynchronous function that returns a Promise
.
Syntax
js
let updating = browser.notifications.update(
id, // string
options // NotificationOptions
)
Parameters
id
-
string
. The ID of the notification to update. This is the same as the ID passed intonotifications.create()
's callback. options
-
notifications.NotificationOptions
. Defines the notification's new content and behavior.
Return value
A Promise
that will be fulfilled with a boolean: true
if the notification was updated, or false
if it was not (for example, because the notification referenced by id
did not exist).
Browser compatibility
BCD tables only load in the browser
Examples
This example uses update()
to update a progress notification. Clicking the browser action shows the notification and starts an alarm
, which we use to update the notification's progress indicator.
Note that you'll need the "alarms" permission to create alarms (as well as the "notifications" permission to create notifications). Also note that Firefox does not support the progress
attribute.
js
let cakeNotification = "cake-notification";
/*
CAKE_INTERVAL is set to 0.3 seconds in this example.
Such a short period is chosen to make the extension's behavior
more obvious, but this is not recommended in real life.
Note that in Chrome, alarms cannot be set for less than
a minute.
*/
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: "Your cake is being prepared…",
message: "Something something cake",
progress,
});
browser.alarms.create(
"cake-progress",
{ periodInMinutes: CAKE_PREP_INTERVAL }
);
});
});
Note: This API is based on Chromium's chrome.notifications
API.