onappinstalled - for when an app is installed.

Chrome has recently (well at least in 2017) implemented window.onappinstalled event. It is triggered when a user installs a progressive web app either via the Add to Homescreen API (the prompt() function on the event delivered via the onbeforeinstallprompt event) or now more importantly via the manual method of Add to Homescreen.

This is a very useful addition because it allows you to see engagement on the prompt vs people who use the system banners or menu buttons to install a progressive web app.

I’ve added it to Airhorner so you can see it in action if DevTools is attached. The code is below that manages onbeforeinstallprompt and onappinstalled - in this case I use onbeforeinstallprompt to defer the install prompt to a custom button, and onappinstalled to clean up the UI and do some basic analytics.

const Installer = function(root) {
  let promptEvent;

  const install = function(e) {
    if(promptEvent) {
        .then(function(choiceResult) {
          // The user actioned the prompt (good or bad).
          // good is handled in 
          promptEvent = null;
          ga('send', 'event', 'install', choiceResult);
        .catch(function(installError) {
          // Boo. update the UI.
          promptEvent = null;
          ga('send', 'event', 'install', 'errored');

  const installed = function(e) {
    promptEvent = null;
    // This fires after onbeforinstallprompt OR after manual add to homescreen.
    ga('send', 'event', 'install', 'installed');

  const beforeinstallprompt = function(e) {
    promptEvent = e;
    ga('send', 'event', 'install', 'available');
    return false;

  window.addEventListener('beforeinstallprompt', beforeinstallprompt);
  window.addEventListener('appinstalled', installed);

  root.addEventListener('click', install.bind(this));
  root.addEventListener('touchend', install.bind(this));

Paul Kinlan

Trying to make the web and developers better.

RSS Github Medium