---
title: BeforeInstallPromptEvent
slug: Web/API/BeforeInstallPromptEvent
tags:
  - API
  - BeforeInstallPromptEvent
  - Event
  - Experimental
  - Interface
  - Reference
translation_of: Web/API/BeforeInstallPromptEvent
---
<div><span style="line-height: 19.0909080505371px;">Событие </span><code><strong>BeforeInstallPromptEvent</strong></code><span style="line-height: 19.0909080505371px;"> запускается в обработчике </span>{{domxref("Window.onbeforeinstallprompt")}} <span style="line-height: 19.0909080505371px;">перед тем, как пользователю будет предложено "установить" веб-сайт на главный экран мобильного устройства.</span></div>

<div><span style="line-height: 19.0909080505371px;">Этот интерфейс наследуется от интерфейса </span>{{domxref("Event")}}<span style="line-height: 19.0909080505371px;">.</span> </div>

<div></div>

<p>{{InheritanceDiagram(700, 60, 20)}}</p>

<h2 id="Конструктор">Конструктор</h2>

<dl>
 <dt>{{domxref("BeforeInstallPromptEvent.BeforeInstallPromptEvent","BeforeInstallPromptEvent()")}}</dt>
 <dd>Создаёт новый <code><strong>BeforeInstallPromptEvent</strong></code>.</dd>
</dl>

<h2 id="Свойства">Свойства</h2>

<p><em>Наследует свойства от своего родителя, {{domxref("Event")}}.</em></p>

<dl>
 <dt>{{domxref("BeforeInstallPromptEvent.platforms")}} {{readonlyinline}}</dt>
 <dd>Возвращает массив элементов {{domxref("DOMString")}}, содержащий платформы, на которых было отправлено событие. Это предусмотрено для пользовательских агентов, которые хотят предоставить пользователю выбор версий, таких как, например, «web» или «play», что позволит пользователю выбирать между веб-версией или версией Android.</dd>
 <dt>{{domxref("BeforeInstallPromptEvent.userChoice")}} {{readonlyinline}}</dt>
 <dd>Возвращает {{jsxref("Promise")}}, которое разрешается в {{domxref("DOMString")}}, содержащее либо "accepted" (принято), либо "dismissed" (отклонено).</dd>
</dl>

<h2 id="Методы">Методы</h2>

<dl>
 <dt>{{domxref("BeforeInstallPromptEvent.prompt()")}} </dt>
 <dd>Позволяет разработчику показывать запрос на установку в любое время по своему выбору. Этот метод возвращает {{jsxref("Promise")}}.</dd>
</dl>

<h2 id="Пример">Пример</h2>

<pre class="brush: js notranslate">window.addEventListener("beforeinstallprompt", function(e) {
  // Зарегистрируйте платформы, указанные в качестве параметров, в запросе на установку
  console.log(e.platforms); // e.g., ["web", "android", "windows"]
  e.userChoice.then(function(choiceResult) {
    console.log(choiceResult.outcome); // either "accepted" or "dismissed"
  }, handleError);
});
</pre>

<h2 id="Совместимость_с_браузером">Совместимость с браузером</h2>



<p>{{Compat("api.BeforeInstallPromptEvent")}}</p>