在此页

• 构造函数
• 特性
• 方法
• 范例
• 浏览器兼容性
• 相关话题

BeforeInstallPromptEvent is fired at the Window.onbeforeinstallprompt handler before a user is prompted to "install" a web site to a home screen on mobile.

This interface inherits from the 事件 接口。

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 8.571428571428571%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-20 0 700 60" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/Event" target="_top"><rect x="1" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="38.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Event</text></a><polyline points="76,25  86,20  86,30  76,25" stroke="#D4DDE4" fill="none"/><line x1="86" y1="25" x2="116" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/BeforeInstallPromptEvent" target="_top"><rect x="116" y="1" width="240" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="236" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">BeforeInstallPromptEvent</text></a></svg></div>
					

  a:hover text { fill: #0095DD; pointer-events: all;}
					

构造函数

BeforeInstallPromptEvent()

创建新的 BeforeInstallPromptEvent .

特性

继承的特性来自其父级， 事件 .

BeforeInstallPromptEvent.platforms 只读

Returns an array of DOMString items containing the platforms on which the event was dispatched. This is provided for user agents that want to present a choice of versions to the user such as, for example, "web" or "play" which would allow the user to chose between a web version or an Android version.

BeforeInstallPromptEvent.userChoice 只读

返回 Promise 解析为 DOMString containing either "accepted" or "dismissed".

方法

BeforeInstallPromptEvent.prompt()

Allows a developer to show the install prompt at a time of their own choosing. This method returns a Promise .

范例

window.addEventListener("beforeinstallprompt", function(e) {
  // log the platforms provided as options in an install prompt
  console.log(e.platforms); // e.g., ["web", "android", "windows"]
  e.userChoice.then(function(choiceResult) {
    console.log(choiceResult.outcome); // either "accepted" or "dismissed"
  }, handleError);
});
					

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
BeforeInstallPromptEvent 非标	Chrome 45	Edge ≤79	Firefox No	IE No	Opera No	Safari No	WebView Android 45	Chrome Android 45	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android 5.0
BeforeInstallPromptEvent() 构造函数 非标	Chrome 45	Edge ≤79	Firefox No	IE No	Opera No	Safari No	WebView Android 45	Chrome Android 45	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android 5.0
平台 非标	Chrome 45	Edge ≤79	Firefox No	IE No	Opera No	Safari No	WebView Android 45	Chrome Android 45	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android 5.0
prompt 非标	Chrome 45	Edge ≤79	Firefox No	IE No	Opera No	Safari No	WebView Android 45	Chrome Android 45	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android 5.0
userChoice 非标	Chrome 45	Edge ≤79	Firefox No	IE No	Opera No	Safari No	WebView Android 45	Chrome Android 45	Firefox Android No	Opera Android No	Safari iOS No	Samsung Internet Android 5.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

元数据

• 最后修改： Apr 30, 2020