WorkerNavigator:setAppBadge() 方法

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

WorkerNavigator 介面的 setAppBadge() 方法可在與此應用關聯的圖示上設定徽章。如果向該方法傳遞了值,則該值將作為徽章的值。否則,徽章將顯示為一個點,或由平臺定義的其他指示器。

語法

js
setAppBadge()
setAppBadge(contents)

引數

contents 可選

一個 number,將用作徽章的值。如果 contents0,則徽章將被設定為 nothing,表示已清除徽章。

返回值

一個 Promise,它會解析為 undefined

異常

InvalidStateError DOMException

如果文件未完全啟用,則會丟擲此異常。

SecurityError DOMException

如果呼叫受到 同源策略 的阻止,則會丟擲此異常。

NotAllowedError DOMException

如果 PermissionStatus.state 不是 granted,則會丟擲此異常。

示例

在下面的示例中,將未讀計數傳遞給了 setAppBadge()。然後,徽章應顯示 30

js
const unread = 30;
navigator.setAppBadge(unread);

規範

此特性似乎未在任何規範中定義。

瀏覽器相容性

另見