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);

规范

此特性似乎未在任何规范中定义。

浏览器兼容性

另见