Window: beforeinstallprompt Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("beforeinstallprompt", (event) => {});

onbeforeinstallprompt = (event) => {};

Ein BeforeInstallPromptEvent. Erbt von Event.

Erbt Eigenschaften von seinem Elternteil, Event.

BeforeInstallPromptEvent.platforms Nur lesbar Nicht standardisiert Experimentell

Gibt ein Array von Zeichenfolgen zurück, das die Plattformen enthält, auf denen das Ereignis ausgelöst wurde. Dies wird für Benutzeragenten bereitgestellt, die dem Benutzer eine Auswahl an Versionen präsentieren möchten, wie zum Beispiel "web" oder "play", wodurch der Benutzer zwischen einer Webversion oder einer Android-Version wählen kann.

BeforeInstallPromptEvent.userChoice Nur lesbar Nicht standardisiert Experimentell

Gibt ein Promise zurück, das sich in ein Objekt auflöst, das die Entscheidung des Benutzers beschreibt, als er aufgefordert wurde, die App zu installieren.

BeforeInstallPromptEvent.prompt() Nicht standardisiert Experimentell

Zeigt eine Aufforderung an, in der der Benutzer gefragt wird, ob er die App installieren möchte. Diese Methode gibt ein Promise zurück, das sich in ein Objekt auflöst, das die Entscheidung des Benutzers beschreibt, als er aufgefordert wurde, die App zu installieren.

Im folgenden Beispiel bietet eine App ihre eigene Installationsschaltfläche an, die eine id von "install" hat. Anfänglich ist die Schaltfläche verborgen.

<button id="install" hidden>Install</button>

Der beforeinstallprompt-Handler:

• Bricht das Ereignis ab, was verhindert, dass der Browser auf einigen Plattformen seine eigene Installations-UI anzeigt
• Weist das BeforeInstallPromptEvent Objekt einer Variablen zu, damit es später verwendet werden kann
• Zeigt die Installationsschaltfläche der App an.

let installPrompt = null;
const installButton = document.querySelector("#install");

window.addEventListener("beforeinstallprompt", (event) => {
  event.preventDefault();
  installPrompt = event;
  installButton.removeAttribute("hidden");
});

Beim Klick auf die Installationsschaltfläche der App:

• Ruft die prompt() Methode des gespeicherten Ereignisobjekts auf, um die Installationsaufforderung auszulösen.
• Setzt seinen Zustand zurück, indem die installPrompt Variable gelöscht und sich die Schaltfläche erneut verbirgt.

installButton.addEventListener("click", async () => {
  if (!installPrompt) {
    return;
  }
  const result = await installPrompt.prompt();
  console.log(`Install prompt was: ${result.outcome}`);
  installPrompt = null;
  installButton.setAttribute("hidden", "");
});

• BeforeInstallPromptEvent.prompt
• BeforeInstallPromptEvent