BeforeInstallPromptEvent: prompt() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.

Die prompt()-Methode der BeforeInstallPromptEvent Schnittstelle ermöglicht es einem Entwickler, das Installationsfenster zu einem selbst gewählten Zeitpunkt anzuzeigen. Typischerweise wird dies im Ereignishandler für das benutzerdefinierte Installations-UI der App aufgerufen.

Diese Methode muss im Ereignishandler für eine Benutzeraktion (wie z.B. einen Klick auf einen Button) aufgerufen werden und darf nur einmal für eine gegebene Instanz von BeforeInstallPromptEvent aufgerufen werden.

Syntax

js
prompt()

Parameter

Keine.

Rückgabewert

Ein Promise, das in ein Objekt aufgelöst wird, das die folgenden Eigenschaften enthält:

outcome Experimentell Nicht standardisiert

Ein String, der angibt, ob der Benutzer sich entschieden hat, die Anwendung zu installieren oder nicht. Er muss einen der folgenden Werte haben:

  • "accepted": Der Benutzer hat die App installiert.
  • "dismissed": Der Benutzer hat die App nicht installiert.
platform Experimentell Nicht standardisiert

Wenn der Benutzer sich entschieden hat, die App zu installieren, ist dies ein String, der die ausgewählte Plattform benennt. Es ist einer der Werte aus der BeforeInstallPromptEvent.platforms Eigenschaft. Wenn der Benutzer sich entschieden hat, die App nicht zu installieren, ist dies ein leerer String.

Beispiele

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
prompt
ExperimentalNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Has more compatibility info.

Siehe auch