Notification.close()

Limited availability

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

メモ: この機能はウェブワーカー内で利用可能です。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

close() は Notification インターフェイスのメソッドで、表示された通知を閉じたり削除したりするために使用されます。

メモ: この API は、一定時間経過後に通知を画面から消去するだけのために使用すべきではありません。通知が最初に表示された後にユーザーがそれとやりとりすることを防ぐため、このメソッドは通知トレイからも通知を削除するためです。この API の正しい使用方法は、ユーザーに関係がなくなった通知を除去することです（例えば、メッセージアプリなどで、ユーザーが既にウェブページ上の通知を読んだ場合や、音楽アプリですでに次の曲が始まっているため、曲の変更を行うための通知を閉じるなど）。

構文

js
close()

引数

なし。

返値

なし (undefined)。

例

以下のスニペットは、呼び出されたときに options オブジェクトと、それから新しい通知を生成します。を生成し、関数の末尾で、 close() を addEventListener() 関数の中で呼び出し、関連するコンテンツがウェブページで既読になったときに通知を除去します。

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();
    }
  });
}

仕様書

Specification
Notifications API Standard
# dom-notification-close

ブラウザーの互換性

BCD tables only load in the browser

関連情報