Notification.close()

Limited availability

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

Nota: Esta característica está disponible en Web Workers.

Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.

El método close() de la interfaz Notification se utiliza para cerrar/eliminar una notificación mostrada anteriormente.

Nota: Esta API no debe usarse solo para tener la notificación eliminada de la pantalla después de un retraso fijo ya que este método también eliminará la notificación de cualquier bandeja de notificación, evitando que los usuarios interactúen con ella después de que se mostró inicialmente. Un uso válido para esta API sería eliminar una notificación que ya no es relevante (por ejemplo, el usuario ya leyó la notificación en la página web en el caso de una aplicación de mensajería o si ya se está reproduciendo la siguiente canción en una aplicación de música).

Sintaxis

js
close();

Parámetros

Ninguno.

Valor retornado

Ninguno (undefined).

Ejemplos

En el siguiente fragmento, tenemos una función simple que, cuando se llama, crea un objeto options y luego una nueva notificación. Al final de la función, se llama también a close() dentro de la función addEventListener() para eliminar la notificación cuando el contenido relevante ha sido leído en la página web.

js
function spawnNotification(theBody, theIcon, theTitle) {
  var options = {
    body: theBody,
    icon: theIcon,
  };

  var n = new Notification(theTitle, options);
  document.addEventListener("visibilitychange", function () {
    if (document.visibilityState === "visible") {
      // La pestaña es ahora visible, así que cierro/elimino la notificación obsoleta.
      n.close();
    }
  });
}

Especificaciones

Specification
Notifications API
# dom-notification-close

Compatibilidad con navegadores

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.

Véase también