Web Notification API
Web Notification API 是 W3C 制定的标准 Web 接口,允许网页应用向用户发送系统级通知消息。这些通知以操作系统原生的样式弹出,即使用户没有聚焦在当前网页标签页上也能收到。它是实现 Web 应用消息推送能力的核心技术基础,在浏览器通知测试器中,所有测试操作都围绕这一 API 展开。
Notification 权限
浏览器出于安全和隐私考虑,要求网页在发送通知前必须获得用户的明确授权。权限有三种状态:granted(已授权)、denied(已拒绝)和 default(未选择)。用户可以在浏览器地址栏旁边的设置中随时修改权限状态。浏览器通知测试器提供了权限检测和请求功能,帮助开发者测试权限流程的各种情况。
Notification 构造函数
Notification 是 Web Notification API 中的核心构造函数,用于创建通知实例。使用方式为 new Notification(title, options),其中 title 是必填参数,options 是可选配置对象。options 中可以包含 body、icon、image、badge、tag、requireInteraction、silent、vibrate、dir、renotify 等属性。浏览器通知测试器的代码预览功能会展示完整的构造函数调用代码。
Tag(标签标识)
tag 是通知的唯一标识符,用于控制系统如何处理多条相同来源的通知。当两条通知具有相同的 tag 值时,新的通知会替换旧的通知,而不是同时显示。如果不设置 tag,每次调用 Notification 都会显示一条新通知。合理使用 tag 可以避免通知堆积,提升用户体验。
requireInteraction
requireInteraction 是 Notification 选项中的一个布尔值属性。当设置为 true 时,通知会一直显示在屏幕上,直到用户主动点击或关闭通知,而不会自动消失。这适用于需要用户立即关注的重要消息。在浏览器通知测试器中,可以通过高级选项开关快速测试这一属性的效果。
Silent(静默模式)
silent 是 Notification 选项中的布尔值属性,当设置为 true 时,通知不会播放声音,也不会触发振动,即使系统设置了通知音。这适用于后台运行的任务通知或不需要打扰用户的通知场景。在浏览器通知测试器中,可以使用"静默"预设快速配置这一选项。
Vibrate(振动模式)
vibrate 是 Notification 选项中的振动模式参数,接受一个由数字组成的数组。数组中的奇数位表示振动时长(毫秒),偶数位表示暂停时长。例如 [200, 100, 200] 表示振动 200 毫秒、暂停 100 毫秒、再振动 200 毫秒。振动功能仅在支持的移动设备上生效。浏览器通知测试器提供了振动预设,帮助开发者测试不同振动模式的效果。
Renotify(重新通知)
renotify 是 Notification 选项中的布尔值属性,默认为 false。当使用与已有通知相同的 tag 发送新通知时,如果 renotify 为 false,系统只会替换通知内容而不会触发通知动画和声音;如果设置为 true,系统会重新触发通知的显示动画和声音效果。这一选项在需要确保用户注意到通知更新时非常有用。
Dir(文本方向)
dir 是 Notification 选项中的文本方向属性,用于控制通知内容的书写方向。可选值包括 ltr(从左到右)、rtl(从右到左)和 auto(自动检测,默认值)。这一属性对于阿拉伯语、希伯来语等从右到左书写的语言特别重要,确保通知内容的排版方向正确。
Badge 图标
badge 是 Notification 选项中的图标参数,用于设置通知在某些平台(如 Android)上显示的小 badge 图标。与 icon 参数不同,badge 图标通常用于在通知栏中显示一个小型标识,而非通知弹出时的大图标。建议使用 96x96 像素的 PNG 格式图片。
UD5工具箱