Уведомление: метод close()

Ограниченная доступность

Эта функция не является базовой, так как она не работает в некоторых из наиболее широко используемых браузеров.

Защищённый контекст: Эта функция доступна только в защищённых контекстах (HTTPS), в некоторых или всех поддерживающих браузерах.

Примечание: Эта функция доступна в Web Workers.

Метод close() интерфейса Notification используется для закрытия/удаления ранее отображённого уведомления.

Примечание: Не следует использовать этот API только для удаления уведомления с экрана после задержки, так как этот метод также удалит уведомление из любой области уведомлений, предотвратив взаимодействие пользователей с ним после его первоначального отображения. Допустимое использование этого API — удаление уведомления, которое больше не актуально (например, пользователь уже прочитал уведомление на веб-странице в случае приложения для обмена сообщениями или следующая песня уже воспроизводится в музыкальном приложении).

Синтаксис

close()

Параметры

Нет.

Возвращаемое значение

Нет (undefined).

Примеры

В следующем фрагменте кода у нас есть функция, которая при вызове создаёт объект options и затем новое уведомление. В конце функции она также вызывает close() внутри функции addEventListener() для удаления уведомления, когда соответствующий контент был прочитан на веб-странице.

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

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`close`	20	14	22	23	7	42	22	29	16.4	4.0	Нет

См. также

Использование API уведомлений

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Notification/close