BeforeInstallPromptEvent:prompt() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

BeforeInstallPromptEvent 介面的 prompt() 方法允許開發者選擇合適的時間顯示安裝提示。通常,這個方法會在應用程式自定義安裝 UI 的事件處理程式中被呼叫。

此方法必須在使用者操作(例如按鈕點選)的事件處理程式中呼叫,並且對於給定的 BeforeInstallPromptEvent 例項只能呼叫一次。

語法

js
prompt()

引數

無。

返回值

一個 Promise,解析為一個包含以下屬性的物件

outcome 實驗性 非標準

一個字串,指示使用者是否選擇安裝該應用程式。它必須是以下值之一:

  • "accepted":使用者安裝了應用程式。
  • "dismissed":使用者未安裝應用程式。
platform 實驗性 非標準

如果使用者選擇安裝該應用程式,則這是一個字串,命名所選平臺,它是 BeforeInstallPromptEvent.platforms 屬性中的一個值。如果使用者選擇不安裝該應用程式,則這是一個空字串。

示例

請參閱 BeforeInstallPromptEvent 介面的示例

瀏覽器相容性

另見