runtime.onBrowserUpdateAvailable

Fired when an update for the browser is available, but it isn't installed immediately because a browser restart is required.

Syntax

js
browser.runtime.onBrowserUpdateAvailable.addListener(listener)
browser.runtime.onBrowserUpdateAvailable.removeListener(listener)
browser.runtime.onBrowserUpdateAvailable.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)

Checks whether a listener is registered for this event. Returns true if it is listening, false otherwise.

addListener syntax

Parameters

function

The function called when this event occurs.

Examples

Listen for this event:

js
function handleBrowserUpdateAvailable() {
  // handle event
}

browser.runtime.onBrowserUpdateAvailable.addListener(
  handleBrowserUpdateAvailable,
);

Browser compatibility

Note: This API is based on Chromium's chrome.runtime API. This documentation is derived from runtime.json in the Chromium code.