WorkerNavigator:setAppBadge() 方法

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中。

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

语法

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

规范

未找到规范

未找到api.WorkerNavigator.setAppBadge的规范数据。
检查此页面是否存在问题或为其贡献缺少的spec_url mdn/browser-compat-data。还要确保规范包含在 w3c/browser-specs.

浏览器兼容性

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

另请参阅