首页 > web前端 > js教程 > 正文

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

夢幻星辰
发布: 2025-12-13 13:10:03
原创
739人浏览过
通知 API 允许网页发送桌面通知,需按序请求授权、检查权限(granted/denied/default)、创建 Notification 实例;必须由用户手势触发 requestPermission(),支持 body/icon/tag 等配置及 onclick/onclose 事件监听。

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

JavaScript 中的通知 API(Notifications API)是一种允许网页向用户发送桌面通知的浏览器接口,无需依赖第三方库或服务,只要用户授权,就能在系统桌面右下角(Windows/macOS)或通知中心(Linux)弹出轻量级提示。

通知 API 的基本使用流程

要成功发送桌面通知,需按顺序完成三步:请求用户授权、检查权限状态、创建并显示通知。

  • 请求权限:调用 Notification.requestPermission(),返回 Promise,用户点击“允许”或“阻止”后才会进入下一步
  • 检查权限:通过 Notification.permission 获取当前状态("granted""denied""default"),仅当为 "granted" 时才能发通知
  • 创建通知:使用 new Notification(title, options) 实例化,title 必填,options 可选(如 bodyiconbadgetag 等)

一个可直接运行的最小示例

以下代码在用户点击按钮后尝试发送通知,包含权限处理和简单错误反馈:

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免费学习笔记(深入)”;

常见配置项与实用技巧

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

Napkin AI
Napkin AI

Napkin AI 可以将您的文本转换为图表、流程图、信息图、思维导图视觉效果,以便快速有效地分享您的想法。

Napkin AI 2238
查看详情 Napkin AI
  • 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是什么_如何向用户发送桌面通知的详细内容,更多请关注php中文网其它相关文章!

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号