大网数据广告活动
Web 标准与前端开发

WorkerNavigator:setAppBadge() 方法

· 52CE 我爱测

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

Badging API

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

语法

setAppBadge()
setAppBadge(contents)

参数

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

返回值

一个兑现 undefined 的 Promise。

异常

  • InvalidStateError DOMException
    • : 如果文档未完全激活,则抛出该异常。
  • SecurityError DOMException
    • : 如果调用被同源策略阻止,则抛出该异常。
  • NotAllowedError DOMException
    • : 如果 PermissionStatus.state 不是 granted,则抛出该异常。

示例

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

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。