通知:close() 方法
注意: 此功能在 Web Workers 中可用。
close()
是 Notification
接口的方法,用于关闭/移除之前显示的通知。
注意: 此 API 不应该仅仅用于在固定延迟后将通知从屏幕上移除,因为此方法还会将通知从任何通知托盘中移除,从而阻止用户在通知首次显示后与其进行交互。此 API 的有效用途是移除不再相关的通知(例如,在消息应用程序的情况下,用户已在网页上阅读了通知,或者在音乐应用程序的情况下,下一首歌已在播放)。
语法
js
close()
参数
无。
返回值
无 (undefined
).
示例
在以下代码片段中,我们有一个简单的函数,当被调用时会创建一个 options
对象,然后创建一个新的通知。在函数的末尾,它还在 addEventListener()
函数中调用 close()
,以便在网页上阅读相关内容时移除通知。
js
function spawnNotification(theBody, theIcon, theTitle) {
const options = {
body: theBody,
icon: theIcon,
};
const n = new Notification(theTitle, options);
document.addEventListener("visibilitychange", () => {
if (document.visibilityState === "visible") {
// The tab has become visible so clear the now-stale Notification.
n.close();
}
});
}
规范
规范 |
---|
通知 API 标准 # dom-notification-close |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。