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.

Пример

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