window.onbeforeinstallprompt

The Window.onbeforeinstallprompt property is an event handler for processing a beforeinstallprompt, which is dispatched on devices when a user is about to be prompted to "install" a web application. Its associated event may be saved for later and used to prompt the user at a more suitable time.

Syntax

window.addEventListener("beforeinstallprompt", function(event) { ... });
window.onbeforeinstallprompt = function(event) { ...};

Example

The following example uses the beforeinstallprompt event handler to make an install button operable, by using the event inside a click handler.

window.addEventListener("beforeinstallprompt", function(e) {
  e.preventDefault(); // Prevents immediate prompt display

  // Shows prompt after a user clicks an "install" button
  installButton.addEventListener("click", function(e) {
    e.prompt();
  });

  installButton.hidden = false; // Make button operable
});

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See Also

• BeforeInstallPromptEvent.prompt
• BeforeInstallPromptEvent