notifications.onClicked
Fired when the user clicks a notification, but not on any of the notification's buttons (for that, see notifications.onButtonClicked
).
Syntax
js
browser.notifications.onClicked.addListener(listener)
browser.notifications.onClicked.removeListener(listener)
browser.notifications.onClicked.hasListener(listener)
Events have three functions:
addListener(listener)
-
Adds a listener to this event.
removeListener(listener)
-
Stop listening to this event. The
listener
argument is the listener to remove. hasListener(listener)
-
Check whether
listener
is registered for this event. Returnstrue
if it is listening,false
otherwise.
addListener syntax
Parameters
listener
-
The function called when this event occurs. The function is passed this argument:
notificationId
-
string
. ID of the notification that the user clicked.
Browser compatibility
BCD tables only load in the browser
Examples
In this simple example we add a listener to the notifications.onClicked
event to listen for system notifications being clicked. When this occurs, we log an appropriate message to the console.
js
browser.notifications.onClicked.addListener((notificationId) => {
console.log(`Notification ${notificationId} was clicked by the user`);
});
Note: This API is based on Chromium's chrome.notifications
API.