Notification:close() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

备注: 此特性在 Web Worker 中可用。

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") {
      // 该选项卡已变得可见,因此清除了现在过时的通知。
      n.close();
    }
  });
}

规范

Specification
Notifications API
# dom-notification-close

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
close

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

参见