BeforeInstallPromptEvent:prompt() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

BeforeInstallPromptEvent 接口的 prompt() 方法允许开发者选择合适的时间显示安装提示。通常,这个方法会在应用程序自定义安装 UI 的事件处理程序中被调用。

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

语法

js
prompt()

参数

无。

返回值

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

outcome 实验性 非标准

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

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

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

示例

请参阅 BeforeInstallPromptEvent 接口的示例

浏览器兼容性

另见