MDN self-hosted library · e01.org

runtime.onBrowserUpdateAvailable

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

[!WARNING] This event has been deprecated. Use runtime.onRestartRequired instead.

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

Syntax

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:

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.