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

JavaScript 中的通知 API(Notifications API)是一种允许网页向用户发送桌面通知的浏览器接口,无需依赖第三方库或服务,只要用户授权,就能在系统桌面右下角(Windows/macOS)或通知中心(Linux)弹出轻量级提示。
要成功发送桌面通知,需按顺序完成三步:请求用户授权、检查权限状态、创建并显示通知。
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),显示在左侧;若不设,可能显示网站 faviconbadge:小徽章图标(如未读数),在 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是什么_如何向用户发送桌面通知的详细内容,更多请关注php中文网其它相关文章!
java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号