W3cubDocs

BeforeInstallPromptEvent

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The BeforeInstallPromptEvent is the interface of the beforeinstallprompt event fired at the Window object before a user is prompted to "install" a website to a home screen on mobile.

This interface inherits from the Event interface.

Constructor

BeforeInstallPromptEvent() Non-standard Experimental: Creates a new BeforeInstallPromptEvent object.

Instance properties

Inherits properties from its parent, Event.

BeforeInstallPromptEvent.platforms Read only Non-standard Experimental: Returns an array of string items containing the platforms on which the event was dispatched. This is provided for user agents that want to present a choice of versions to the user such as, for example, "web" or "play" which would allow the user to choose between a web version or an Android version.
BeforeInstallPromptEvent.userChoice Read only Non-standard Experimental: Returns a Promise that resolves to a string containing either "accepted" or "dismissed".

Instance methods

BeforeInstallPromptEvent.prompt() Experimental: Allows a developer to show the install prompt at a time of their own choosing. This method returns a Promise.

Example

window.addEventListener("beforeinstallprompt", (e) => {
  // log the platforms provided as options in an install prompt
  console.log(e.platforms); // e.g., ["web", "android", "windows"]
  e.userChoice.then((choiceResult) => {
    console.log(choiceResult.outcome); // either "accepted" or "dismissed"
  }, handleError);
});

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`BeforeInstallPromptEvent`	44	79	No	No	31	No	44	44	No	32	No	5.0
`BeforeInstallPromptEvent`	44	79	No	No	31	No	44	44	No	32	No	5.0
`platforms`	44	79	No	No	31	No	44	44	No	32	No	5.0
`prompt`	76 The object returned by the promise returns a property called `outcome` instead of `userChoice`. 44–76 Resolved with an empty promise.	79 The object returned by the promise returns a property called `outcome` instead of `userChoice`.	No	No	63 The object returned by the promise returns a property called `outcome` instead of `userChoice`. 31–63 Resolved with an empty promise.	No	76 The object returned by the promise returns a property called `outcome` instead of `userChoice`. 44–76 Resolved with an empty promise.	76 The object returned by the promise returns a property called `outcome` instead of `userChoice`. 44–76 Resolved with an empty promise.	No	54 The object returned by the promise returns a property called `outcome` instead of `userChoice`. 32–54 Resolved with an empty promise.	No	5.0
`userChoice`	44	79	No	No	31	No	44	44	No	32	No	5.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BeforeInstallPromptEvent