Badging API
WorkerNavigator 接口的 setAppBadge() 方法在与此应用关联的图标上设置徽章。如果将值传递给该方法,则该值将被设置为徽章的值。否则,徽章将显示为点或平台定义的其他指示器。
语法
setAppBadge()
setAppBadge(contents)
参数
contents- : 一个将用作徽章值的Number。如果
contents为0,则徽章将设置为nothing,表示已清除徽章。
- : 一个将用作徽章值的Number。如果
返回值
一个兑现 undefined 的 Promise。
异常
InvalidStateErrorDOMException- : 如果文档未完全激活,则抛出该异常。
SecurityErrorDOMException- : 如果调用被同源策略阻止,则抛出该异常。
NotAllowedErrorDOMException- : 如果 PermissionStatus.state 不是
granted,则抛出该异常。
- : 如果 PermissionStatus.state 不是
示例
在下面的示例中,未读的计数被传递给 setAppBadge()。然后徽章应显示 30。
const unread = 30;
navigator.setAppBadge(unread);
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
