Notification是HTML5新增的API,用于向用户配置和显示桌面通知。上次在别的网站上看到别人的通知弹窗,好奇之余也想知道如何实现的。实际去查一下发现并不复杂,且可以说比较简单,故写篇博客分享给大家,希望能帮你们了解这个API。npm包:我还发了一个npm包:notification-Koro1,非常轻量简洁,觉得不错的话,点个Star吧chrome下Notification的表现:以谷歌为例,一开始需要用户允许通知:允许通知之后,显示的通知长这样:Notification特性该通知是脱离浏览器的,即使用户没有停留在当前标签页,甚至最小化了浏览器,也会在主屏幕的右上角显示通知,然后在一段时间后消失。我们可以监听通知的显示,点击,关闭等事件,比如点击通知打开一个页面。博客、前端积累文档、公众号、GitHub栗子:去各个网站里面的控制台去运行API的具体细节,等下再说,先试试这个API下面是一个简单的栗子,大家可以先在各个网站的控制台里面运行查看Notification的效果:var options = { dir: “auto”, // 文字方向 body: “通知:OBKoro1评论了你的朋友圈”, // 通知主体 requireInteraction: true, // 不自动关闭通知 // 通知图标 icon: “https://upload-images.jianshu.io/upload_images/5245297-818e624b75271127.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240"};notifyMe('这是通知的标题’, options);function notifyMe(title, options) { // 先检查浏览器是否支持 if (!window.Notification) { console.log(‘浏览器不支持通知’); } else { // 检查用户曾经是否同意接受通知 if (Notification.permission === ‘granted’) { var notification = new Notification(title, options); // 显示通知 } else if (Notification.permission === ‘default’) { // 用户还未选择,可以询问用户是否同意发送通知 Notification.requestPermission().then(permission => { if (permission === ‘granted’) { console.log(‘用户同意授权’); var notification = new Notification(title, options); // 显示通知 } else if (permission === ‘default’) { console.warn(‘用户关闭授权 未刷新页面之前 可以再次请求授权’); } else { // denied console.log(‘用户拒绝授权 不能显示通知’); } }); } else { // denied 用户拒绝 console.log(‘用户曾经拒绝显示通知’); } }}浏览器支持:MDN:目前Notification除了IE浏览器不支持外, 其他浏览器都已支持桌面通知,移动端浏览器基本都未支持。因为兼容性问题,所以在使用Notification之前,我们需要查看浏览器是否支持Notification这个API:if(window.Notification){ // 桌面通知的逻辑}通知权限:为了避免网站滥用通知扰民,在向用户显示通知之前,需要经过用户同意。Notification.permission 用于表明当前通知显示的授权状态,它有三个值:default : 默认值,用户还未选择granted : 用户允许该网站发送通知denied : 用户拒绝该网站发送通知检测权限:检测浏览器是否支持Notification之后,需要检测一下用户通知权限。 if (Notification.permission === ‘granted’) { console.log(‘用户曾经同意授权’); // 随时可以显示通知 } else if (Notification.permission === ‘default’) { console.log(‘用户还未选择同意/拒绝’); // 下一步请求用户授权 } else { console.log(‘用户曾经拒绝授权 不能显示通知’); }请求权限当Notification.permission为default的时候,我们需要使用Notification.requestPermission()来请求用户权限。Notification.requestPermission()基于promise语法,then的回调函数参数是用户权限的状态Notification.permission的值。Notification.requestPermission().then(permission => { if (permission === ‘granted’) { console.log(‘用户同意授权’); // 随时可以显示通知 } else if (permission === ‘default’) { console.log(‘用户关闭授权 可以再次请求授权’); } else { console.log(‘用户拒绝授权 不能显示通知’); }});// 老版本使用的是回调函数机制:Notification.requestPermission(callback); 参数一样推送通知当Notification.permission为granted 时,请求到用户权限之后,不必立即发送通知,可以在任意时刻,以任意形式来发送通知。const options = {}; // 传空配置const title = ‘这里是标题’;const notification = new Notification(title, options) // 显示通知上面这段代码就可以显示一个简单的通知了,只要用户允许你弹窗。Notification的参数:title:通知的标题options:通知的设置选项(可选)。body:字符串。通知的body内容。tag:代表通知的一个识别标签,相同tag时只会打开一个通知窗口。icon:字符串。要在通知中显示的图标的URL。data:想要和通知关联的数据,可以在new Notification返回的实例中找到。renotify: 布尔值。相同tag,新通知出现的时候是否替换之前的(开启此项,tag必须设置)。requireInteraction:布尔值。通知不自动关闭,默认为false(自动关闭)。还有一些不太重要的配置可以看张鑫旭老师的博客和MDN的介绍requireInteraction: 保持通知不自动关闭默认值为false,通知会在三四秒之后自动关闭。当设置为true,并且当有超过两个通知(new Notification(title, options))时,会出现如下图的通知叠加状态。这种情况显然,我们只能默认操作最后一个通知,除非你把每个通知返回的实例都保存下来。我发布的npm包:notification-koro1,可以自定义一定的时间间隔自动关闭不自动关闭的通知,也可以一次性关闭所有通知PS:如果没有触发叠加,很可能是因为你两次通知的tag配置项是相同的(相同tag只能出现一个弹窗)。PS: safari下不支持该选项,默认自动关闭renotify:相同默认值为false,chorme下相同tag的通知不替换,还是老的通知设置为true, 两个相同tag的通知,新通知替换之前旧的通知。注意:使用renotify,必须要同时设置tag选项,否则将会报错。PS: safari下不支持该选项,默认两个相同tag的通知,新通知替换之前旧的通知。Notification的实例:生成通知,会返回一个实例,如下:const instanceNotification = new Notification(title, options)instanceNotification就是当前通知的实例,在该实例上,我们可以查询该通知的配置,监听事件,调用实例方法。下文都以instanceNotification指代通知返回的实例。通知的配置:在通知实例上可以读取到设置通知时的所有配置,比如:通知标题:instanceNotification. title、通知内容:instanceNotification. body 、通知图标:instanceNotification. icon等。PS: 这些属性都是只读的,不能删除,不能修改,不能遍历。事件处理:我们可以使用通知的实例来监听通知的事件:click: 用户点击通知时被触发show: 通知显示的时候被触发error: 通知遇到错误时被触发close: 用户关闭通知时被触发instanceNotification.onclick = e => { // do something 可以是:打开网址,发请求,关闭通知等}注意:最好是一发出通知就立即监听事件,否则有些事件可能一开始没被触发或永远不会触发。例如:用定时器5秒后才监听通知的点击和显示事件,则永远不会触发通知显示的回调,点击事件在5秒后才可以正常起作用但会错误五秒之前用户的点击。关闭通知instanceNotification.close()没有设置不自动关闭的话,chrome通知将会在4.5秒左右自动关闭通知,safari则是5秒钟(无法设置不自动关闭)。notification没有定时控制通知多久后消失的功能,当出现多个通知,也无法统一关闭。这两个问题,在我发布的NPM包:notification-koro1中,都解决掉了,并提供更清晰的回调应用场景即时通讯软件(邮件、聊天室)体育赛事结果彩票/抽奖结果新闻网站重大新闻通知网站的重大更新,重大新闻等。notification其他这里是一些API/浏览器细节,以及可能会遇到的问题,可以先不看,等真正遇到了,回头再来看。用户拒绝显示通知:一旦用户禁止网站显示通知,网站就不能再请求用户授权显示通知,需要用户去设置中更改。chrome浏览器的通知设置位置:设置>高级>内容设置>通知saafari浏览器:偏好设置>网站>通知>找到网站>修改权限/恢复默认关闭请求权限:在chorme浏览器中:当用户关闭请求权限的弹窗(右上角的叉叉),页面还没刷新,我们可以再次向用户请求权限。页面刷新过后,浏览器默认用户拒绝。在safari浏览器下,没有关闭请求权限的选项,用户必须选择同意/拒绝。icon不显示问题:可能是网站进行了同源限制(比如github),不是域名下面的图片,会报错,不能调用。tag:tag相同的通知,同时只能出现一个,老通知是否会被覆盖取决于:renotify配置和浏览器。chrome下:当通知关闭之后,上次出现过的tag在一段时间内,不能再出现,比如刷新页面再请求相同tag的通知。(在safari下正常出现)safari下面不能显示icon在safari下面,同一个网站(比如谷歌),同样的代码,chorme可以正常显示icon,safari却没有icon,也没有报错。谷歌之后发现,在stack overflow里面看到safari只支持body和tag选项,并不支持icon选项。连续触发在safari和chrome下短时间内连续触发通知(不设tag,不设requireInteraction),会出现如下表现:这个表现,通知没有icon、标题、内容,就显得没有意义了,浏览器以这种形式,限制开发者不要频繁打扰用户。notification-Koro1:试一下notification-Koro1啦, 持续维护,简单方便~结语本文写的比较细,可以先mark一下,然后以后真正用到这个API了,可以先通过文中的栗子,然后再查找对应的内容。还有就是注意浏览器间的差异,我自己就试了chrome和safari,然后这两个浏览器在实现细节上有很多不一样的地方,开发的时候注意一下。博客、前端积累文档、公众号、GitHub参考资料:notification-Koro1简单了解HTML5中的Web Notification桌面通知Notification MDNHTML5 桌面通知:Notification API