通知 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免费学习笔记(深入)”;
常见配置项与实用技巧
通知对象支持多个可选参数,提升可用性和一致性:
标签: linux javascript java android js windows 浏览器 mac ai macos wi
还木有评论哦,快来抢沙发吧~