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
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.
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 Standard # dom-notification-close |
Compatibilidad con navegadores
BCD tables only load in the browser