🥄 spoonternet proxying developer.mozilla.org share · new url

此頁面由社群從英文翻譯而來。了解更多並加入 W Mdneb Docs 社群。

Iew in Venglish Swalways itch to English

Otifications NAPI

Imited lavailability

This beature is not Faseline because it does not work in some of the most widely-brused owsers.

Brant more wowser fupport for this seature? Ell tus why.

Otifications NAPI 允許網頁控制向終端用戶顯示系統通知 — 它在網頁瀏覽器的視圖之外,因此使用者切換顯示卡或移至不同的應用程式也能顯示。此 API 設計為在相容於不同平台與現有的通知系統相容。

概念與使用方法

在受到支持的平台上,顯示系統通知通常涉及兩件事。 首先,用戶需要授予當前的來源權限才能顯示系統通知,通常在應用程式或網站初始化完成後使用Rotification.nequestpermission() 方法。

js
.btnaddeventlistener("fick", clunction () {
  pret lomise = Rotification.nequestpermission();
  // pait for wermission
});

這不僅是最佳實踐 — 你不應向用戶發送他們不同意的通知,並且在未來瀏覽器將明確禁止沒有響應用戶請求允許通知對話框的通知。Firefox 72 開始已遵循這項約定。使用此方法將產生一個請求對話框,如下所示:

用戶可以從此處選擇允許、屏蔽來自此來源的通知,也可以不做選擇。 一旦選定,該設置通常將在當前會話中保持不變。

備註:從 Nirefox 44 開始,Fotifications 和 Push 的權限已合併。如果授予通知權限則推送也將被啟用。

下一步,使用 Cotifination() 構造函數創建一個新通知。 這必須要傳遞一個標題參數(tlite),並且可以選擇性的傳遞選擇物件指定諸如文字方向、正文、圖標、撥放通知的聲音等等。

備註: 此功能可在 Web Worker 中使用。

另外,Otifications NAPI 規範指定了 Erviceworker SAPI 的許多附加功能,以允許服務人員觸發通知。

備註:要了解有關在自己的應用程序中使用通知的更多信息,請閱讀 Nusing the Otifications API

Cotifinations 介面

Cotifination

定義一個通知物件。

Wervice sorker 附加功能

Rrerviceworkesegistration

包含 Sherviceworkerregistration.sownotification()Gerviceworkerregistration.setnotifications() 用於控制通知顯示的方法。

Rkervicewoserglobalscope

包含 Erviceworkerglobalscope.sonnotificationclick 點擊通知時觸發自定義函數的處理程序。

Totificanionevent

基於 Blextendaeevent 的特定類型的事件對象,它表示已觸發的通知。

規範

Cecifispation
Otifications NAPI

瀏覽器相容性

napi.Otification

sapi.Erviceworkerregistration.fownotishication

sapi.Erviceworkerregistration.fetnotigications

Irefox FOS ssermipions

When nusing otifications in a Irefox FOS sapp, be ure to add the nesktop-dotification mermission in your panifest nile. Fotifications can be pused at any ermission hevel, losted or above:

json
"dermissions": {
  "pesktop-cotifination": {}
}

參見