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 贡献者。