通知 API 允许网页发送桌面通知,需按序请求授权、检查权限(granted/denied/default)、创建 Notification 实例;必须由用户手势触发 requestPermission(),支持 body/icon/tag 等配置及 onclick/onclose 事件监听。

JavaScript 中的通知 API(Notifications API)是一种允许网页向用户发送桌面通知的浏览器接口,无需依赖第三方库或服务,只要用户授权,就能在系统桌面右下角(Windows/macOS)或通知中心(Linux)弹出轻量级提示。
通知 API 的基本使用流程
要成功发送桌面通知,需按顺序完成三步:请求用户授权、检查权限状态、创建并显示通知。
请求权限:调用 Notification.requestPermission(),返回 Promise,用户点击“允许”或“阻止”后才会进入下一步 检查权限:通过 Notification.permission 获取当前状态("granted"、"denied" 或 "default"),仅当为 "granted" 时才能发通知 创建通知:使用 new Notification(title, options) 实例化,title 必填,options 可选(如 body、icon、badge、tag 等)
一个可直接运行的最小示例
以下代码在用户点击按钮后尝试发送通知,包含权限处理和简单错误反馈:
document.getElementById('notifyBtn').addEventListener('click', async () => { if (Notification.permission === 'granted') { new Notification('你好!', { body: '这是一条桌面通知' }); } else if (Notification.permission === 'default') { const permission = await Notification.requestPermission(); if (permission === 'granted') { new Notification('你好!', { body: '授权成功,通知已发出' }); } } else { alert('通知已被禁用,请在浏览器设置中开启'); }});
注意:requestPermission() 必须由用户手势(如 click、tap)触发,不能在页面加载时自动调用,否则多数浏览器会静默拒绝。
立即学习“Java免费学习笔记(深入)”;
常见配置项与实用技巧
通知对象支持多个可选参数,提升可用性和一致性:
body:通知正文文字,显示在标题下方 icon:小图标 URL(建议 64×64 PNG),显示在左侧;若不设,可能显示网站 favicon badge:小徽章图标(如未读数),在 Android 或 PWA 中更常用 tag:唯一标识符,相同 tag 的新通知会替换旧通知(避免重复刷屏) data:任意 JS 值,可用于事件回调中传递上下文(如点击后跳转特定页面)
例如:new Notification('订单更新', { body: '你的订单已发货', tag: 'order-123', icon: '/img/ship.png' })
监听通知交互事件
你可以响应用户的操作,比如点击通知或关闭通知:
notification.onclick:用户点击通知时触发,常用于聚焦窗口或跳转页面 notification.onclose:用户手动关闭或超时自动关闭后触发 notification.onerror:通知因权限、资源加载失败等原因无法显示时触发
示例:
const n = new Notification('点击查看', { body: '点我打开详情页' });n.onclick = () => { window.focus(); // 激活浏览器窗口 window.location.href = '/order/123';};
基本上就这些。通知 API 简单直接,但权限逻辑和触发时机容易出错,重点是确保用户主动触发 + 明确处理三种权限状态。不是所有浏览器都完全支持全部选项(如 badge 在桌面端支持有限),上线前建议在目标环境中实测。
以上就是javascript中的通知API是什么_如何向用户发送桌面通知的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1542015.html
微信扫一扫
支付宝扫一扫