BeforeInstallPromptEvent

Limited availability

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

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Не стандартно: Эта функция не стандартизирована. Мы не рекомендуем использовать нестандартные функции в действующих проектах, так как их поддержка браузерами ограничена, а поведение может измениться или быть удалено. Тем не менее, в некоторых случаях, когда нет стандартного решения, они могут быть подходящей альтернативой.

Событие BeforeInstallPromptEvent запускается в обработчике Window.onbeforeinstallprompt перед тем, как пользователю будет предложено "установить" веб-сайт на главный экран мобильного устройства.Этот интерфейс наследуется от интерфейса Event.

Event BeforeInstallPromptEvent

Конструктор

BeforeInstallPromptEvent()

Создаёт новый BeforeInstallPromptEvent.

Свойства

Наследует свойства от своего родителя, Event.

BeforeInstallPromptEvent.platforms Только для чтения

Возвращает массив элементов DOMString, содержащий платформы, на которых было отправлено событие. Это предусмотрено для пользовательских агентов, которые хотят предоставить пользователю выбор версий, таких как, например, «web» или «play», что позволит пользователю выбирать между веб-версией или версией Android.

BeforeInstallPromptEvent.userChoice Только для чтения

Возвращает Promise, которое разрешается в DOMString, содержащее либо "accepted" (принято), либо "dismissed" (отклонено).

Методы

BeforeInstallPromptEvent.prompt()

Позволяет разработчику показывать запрос на установку в любое время по своему выбору. Этот метод возвращает Promise.

Пример

js
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);
});