Navigator：setAppBadge() 方法

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中。

setAppBadge()是Navigator接口的一个方法，用于在与此应用程序关联的图标上设置徽章。如果向方法传递值，则此值将设置为徽章的值。否则，徽章将显示为圆点或平台定义的其他指示器。

语法

js
setAppBadge()
setAppBadge(contents)

参数

contents 可选

一个number，将用作徽章的值。如果 contents 为 0，则徽章将设置为 nothing，表示已清除徽章。

返回值

一个Promise，解析为undefined。

异常

InvalidStateError DOMException

如果文档未完全激活，则抛出此异常。

SecurityError DOMException

如果调用被同源策略阻止，则抛出此异常。

NotAllowedError DOMException

如果PermissionStatus.state 不是 granted，则抛出此异常。

示例

在下面的示例中，未读计数传递给 setAppBadge()。然后徽章应显示 30。

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

规范

规范
徽章 API
# setappbadge-method

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅