Notification:close() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

Notification 接口的 close() 方法用于关闭/移除之前显示的通知。

注意: 不应仅为了在固定延迟后从屏幕上移除通知而使用此 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();
    }
  });
}

规范

规范
Notifications API
# dom-notification-close

浏览器兼容性

另见