通知:close() 方法

安全上下文: 此功能仅在 安全上下文 (HTTPS) 中,在某些或所有 支持的浏览器 中可用。

注意: 此功能在 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 的浏览器中加载。

另请参见