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

瀏覽器相容性

另見