BeforeInstallPromptEvent
Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.
Не стандартно: Эта возможность не является стандартной и стандартизировать её пока никто не собирается. Не используйте её на сайтах, смотрящих во внешний мир: она будет работать не у всех пользователей. Также могут присутствовать большие несовместимости между реализациями и её поведение может в будущем измениться.
Событие BeforeInstallPromptEvent
запускается в обработчике Window.onbeforeinstallprompt
перед тем, как пользователю будет предложено "установить" веб-сайт на главный экран мобильного устройства.Этот интерфейс наследуется от интерфейса Event
.
Конструктор
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);
});
Спецификации
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