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.

must be a string

Конструктор

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

Спецификации

No specification found

No specification data found for api.BeforeInstallPromptEvent.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Совместимость с браузерами

BCD tables only load in the browser