BeforeInstallPromptEvent: prompt() 方法

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细检查 浏览器兼容性表

非标准: 此功能是非标准的,并且不在标准化轨道上。请勿在面向 Web 的生产网站上使用它:它不会对每个用户都有效。不同实现之间也可能存在很大的不兼容性,并且行为可能会在将来发生改变。

prompt() 方法是 BeforeInstallPromptEvent 接口的一部分,它允许开发者在他们选择的时间显示安装提示。通常情况下,这将在应用程序自定义安装 UI 的事件处理程序中调用。

此方法必须在用户操作(例如,按钮点击)的事件处理程序中调用,并且在一个给定的 BeforeInstallPromptEvent 实例上只能调用一次。

语法

js
prompt()

参数

无。

返回值

一个解析为包含以下属性的对象的 Promise

outcome 实验性 非标准

一个字符串,指示用户是否选择安装应用程序。它必须是以下值之一

  • "accepted": 用户安装了应用程序。
  • "dismissed": 用户没有安装应用程序。
platform 实验性 非标准

如果用户选择安装应用程序,则这是一个字符串,命名所选平台,它来自 BeforeInstallPromptEvent.platforms 属性的值。如果用户选择不安装应用程序,则这是一个空字符串。

示例

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅