Navigator：setAppBadge() 方法

可用性有限

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

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

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

語法

setAppBadge()
setAppBadge(contents)

contents 可選: 一個 number，將用作徽章的值。如果 contents 為 0，則徽章將被設定為 nothing，表示已清除徽章。

一個 Promise，它會解析為 undefined。

InvalidStateError DOMException: 如果文件未完全啟用，則會丟擲此異常。
SecurityError DOMException: 如果呼叫受到同源策略的阻止，則會丟擲此異常。
NotAllowedError DOMException: 如果 PermissionStatus.state 不是 granted，則會丟擲此異常。

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

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

規範
Badging API # setappbadge-method

此頁面最後修改於 ⁨2023 年 12 月 17 日⁩，作者為 MDN 貢獻者。