通知 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 在桌面端支持有限），上线前建议在目标环境中实测。
