notifications.onShown

{{AddonSidebar}} 

Fired immediately after a notification has been shown.

Syntax

browser.notifications.onShown.addListener(listener)
browser.notifications.onShown.removeListener(listener)
browser.notifications.onShown.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. Returns true 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 has been shown.

Browser compatibility

{{Compat}} 

Examples

Add a listener to the notifications.onShown event and log its details:

function logShown(itemId) {
  console.log(`shown: ${itemId}`);
  browser.notifications.getAll().then((all) => {
    console.log(all[itemId]);
  });
}

browser.notifications.onShown.addListener(logShown);

{{WebExtExamples}} 

[!NOTE] This API is based on Chromium’s chrome.notifications API.