javascript中的通知API是什么_如何向用户发送桌面通知

通知 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）触发，不能在页面加载时自动调用，否则多数浏览器会静默拒绝。

常见配置项与实用技巧

通知对象支持多个可选参数，提升可用性和一致性：

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