Usando la API de Notificaciones

Uno de los casos de uso más obvios para las notificaciones web es una aplicación de correo o IRC (Internet Relay Chat) basada en la web que necesita notificar al usuario cuando se recibe un mensaje nuevo, incluso si el usuario está haciendo otra cosa con otra aplicación. Ahora existen muchos ejemplos de esto, como Slack.

Hemos escrito un ejemplo del mundo real, una aplicación de lista de tareas, para dar una idea más clara de cómo se pueden usar las notificaciones web. Almacena datos localmente usando la API IndexedDB y notifica a los usuarios cuando vencen las tareas usando notificaciones del sistema. Descargue el código de la lista de tareas o vea la aplicación ejecutándose en vivo.

Antes de que una aplicación pueda enviar una notificación, el usuario debe conceder a la aplicación el permiso de hacerlo. Este es un requisito común cuando una API intenta interactuar con algo fuera de una página web; al menos una vez, el usuario debe otorgar específicamente permiso a esa aplicación para presentar notificaciones, lo que le permite controlar qué aplicaciones/sitios pueden mostrar notificaciones.

Debido a los abusos de las notificaciones automáticas en el pasado, los navegadores web y los desarrolladores han comenzado a implementar estrategias para ayudar a mitigar este problema. Solo debe solicitar el consentimiento para mostrar notificaciones en respuesta a un gesto del usuario (por ejemplo, hacer clic en un botón). Esta no es solo la mejor práctica: no debe molestar a los usuarios con notificaciones que no aceptaron, sino que, en el futuro, los navegadores rechazarán explícitamente las solicitudes de permiso de notificación que no se activen en respuesta a un gesto del usuario. Firefox ya lo está haciendo desde la versión 72, por ejemplo, y Safari lo ha hecho durante algún tiempo.

Además, en Chrome y Firefox no puede solicitar notificaciones a menos que el sitio sea un contexto seguro (es decir, HTTPS), y ya no puede permitir que se soliciten permisos de notificación desde un <iframe> de origen cruzado.

Puede verificar si ya tiene permiso comprobando el valor de la propiedad de solo lectura Notification.permission. Puede tener uno de tres valores posibles:

default

Todavía no se le ha pedido permiso al usuario, por lo que no se mostrarán las notificaciones.

granted

El usuario ha dado permiso para mostrar notificaciones, después de habérlo pedido previamente.

denied

El usuario ha rechazado explícitamente el permiso para mostrar notificaciones.

Si aún no se ha otorgado el permiso para mostrar notificaciones, la aplicación debe usar el método Notification.requestPermission() para solicitarlo al usuario. En su forma más simple, solo incluimos lo siguiente:

Notification.requestPermission().then(function (result) {
  console.log(result);
});

Esto utiliza la versión basada en promesas del método. Si desea admitir versiones anteriores, es posible que deba usar la versión callback anterior, que se ve así:

Notification.requestPermission();

La versión callback acepta opcionalmente una función callback que se llama una vez que el usuario ha respondido a la solicitud de permisos de visualización.

En nuestro ejemplo de lista de tareas, incluimos un botón "Habilitar notificaciones" que, cuando se presiona, solicita permisos de notificación para la aplicación.

<button id="enable">Habilitar notificaciones</button>

Al hacer clic, se llama a la función askNotificationPermission():

function askNotificationPermission() {
  // función para pedir los permisos
  function handlePermission(permission) {
    // configura el botón para que se muestre u oculte, dependiendo de lo que
    // responda el usuario
    if (
      Notification.permission === "denied" ||
      Notification.permission === "default"
    ) {
      notificationBtn.style.display = "block";
    } else {
      notificationBtn.style.display = "none";
    }
  }

  // Comprobemos si el navegador admite notificaciones.
  if (!("Notification" in window)) {
    console.log("Este navegador no admite notificaciones.");
  } else {
    if (checkNotificationPromise()) {
      Notification.requestPermission().then((permission) => {
        handlePermission(permission);
      });
    } else {
      Notification.requestPermission(function (permission) {
        handlePermission(permission);
      });
    }
  }
}

Mirando primero el segundo bloque principal, verá que primero verificamos si las notificaciones son compatibles. Si es así, realizamos una comprobación para ver si se admite la versión basada en promesas de Notification.requestPermission(). Si es así, ejecutamos la versión basada en promesas (compatible en todas partes excepto Safari), y si no, ejecutamos la versión anterior basada en callback (que es compatible con Safari).

Para evitar la duplicación de código, hemos almacenado algunos bits de código de mantenimiento dentro de la función handlePermission(), que es el primer bloque principal dentro de este fragmento. Aquí dentro, establecemos explícitamente el valor Notification.permission (algunas versiones antiguas de Chrome fallaron al hacer esto automáticamente), y mostramos u ocultamos el botón dependiendo de lo que el usuario eligió en el cuadro de diálogo de permiso. No queremos mostrarlo si ya se ha otorgado el permiso, pero si el usuario elige negar el permiso, queremos darle la oportunidad de cambiar de opinión más adelante.

Arriba mencionamos que teníamos que verificar si el navegador es compatible con la versión basada en promesas de Notification.requestPermission(). Hicimos esto usando lo siguiente:

function checkNotificationPromise() {
  try {
    Notification.requestPermission().then();
  } catch (e) {
    return false;
  }

  return true;
}

Básicamente tratamos de ver si el método .then() está disponible en requestPermission(). Si es así, continuamos y devolvemos true. Si falla, devolvemos false en el bloque catch() {}.

Crear una notificación es fácil; solo usa el constructor Notification. Este constructor espera un título para mostrar con la notificación y algunas opciones para mejorar la notificación, como icon o un texto body.

Por ejemplo, en el ejemplo de la lista de tareas, usamos el siguiente fragmento para crear una notificación cuando sea necesario (que se encuentra dentro de la función createNotification()):

var img = "/to-do-notifications/img/icon-128.png";
var text = '¡OYE! Tu tarea "' + title + '" ahora está vencida.';
var notification = new Notification("Lista de tareas", {
  body: text,
  icon: img,
});

close() es utilizado para eliminar una notificación que ya no es relevante para el usuario (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 la siguiente canción ya se está reproduciendo en una aplicación de música para notificar los cambios de canción). La mayoría de los navegadores modernos descartan las notificaciones automáticamente después de unos momentos (alrededor de cuatro segundos), pero esto no es algo que generalmente deba preocuparte, ya que depende del usuario y del agente de usuario. El cierre también puede ocurrir a nivel del sistema operativo y los usuarios deben mantener el control de esto. Las versiones anteriores de Chrome no eliminaban las notificaciones automáticamente, por lo que puedes hacerlo después de un setTimeout() solo para esas versiones antiguas para no eliminar las notificaciones de las bandejas de notificaciones en otros navegadores.

var n = new Notification("Mi gran canción");
document.addEventListener("visibilitychange", function () {
  if (document.visibilityState === "visible") {
    // La pestaña se ha vuelto visible, así que borre la Notificación ahora
    // obsoleta.
    n.close();
  }
});

Hay cuatro eventos que se activan en la instancia Notification:

click

Se activa cuando el usuario hace clic en la notificación.

close

Se activa una vez que se cierra la notificación.

error

Se activa si algo sale mal con la notificación; esto generalmente se debe a que la notificación no se pudo mostrar por algún motivo.

show

Se activa cuando la notificación se muestra al usuario.

Estos eventos se pueden rastrear usando los manejadores onclick, onclose (en-US), onerror (en-US) y onshow (en-US). Como Notification también hereda de EventTarget, es posible usar el método addEventListener() en ellos.

Por lo general, no es deseable que un usuario reciba muchas notificaciones en un corto espacio de tiempo; por ejemplo, ¿qué sucede si una aplicación de mensajería notifica a un usuario por cada mensaje entrante y se envían muchos? Para evitar molestar al usuario con demasiadas notificaciones, es posible modificar la cola de notificaciones pendientes, reemplazando una o varias notificaciones pendientes por una nueva.

Para hacer esto, es posible agregar una etiqueta a cualquier notificación nueva. Si una notificación ya tiene la misma etiqueta y aún no se ha mostrado, la nueva notificación reemplaza la notificación anterior. Si ya se ha mostrado la notificación con la misma etiqueta, se cierra la notificación anterior y se muestra la nueva.

Supongamos el siguiente código HTML básico:

<button>¡Notifícame!</button>

Es posible manejar múltiples notificaciones de esta manera:

window.addEventListener("load", function () {
  var button = document.getElementsByTagName("button")[0];

  if (window.self !== window.top) {
    // Asegúrese de que si su documento está en un marco, hagamos que el
    // usuario lo abra primero en su propia pestaña o ventana. De lo contrario,
    // no podrá solicitar permiso para enviar notificaciones.
    button.textContent =
      "Ver el resultado en vivo del código de ejemplo anterior";
    button.addEventListener("click", () => window.open(location.href));
    return;
  }

  button.addEventListener("click", function () {
    // Si el usuario acepta ser notificado.
    // Intentemos enviar diez notificaciones.
    if (window.Notification && Notification.permission === "granted") {
      var i = 0;
      // El uso de un intervalo hace que algunos navegadores (incluido Firefox)
      // bloqueen las notificaciones si hay demasiadas en un tiempo determinado.
      var interval = window.setInterval(function () {
        // Gracias a la etiqueta, solo deberíamos ver la notificación "¡Hola! 9"
        var n = new Notification("¡Hola! " + i, { tag: "soManyNotification" });
        if (i++ == 9) {
          window.clearInterval(interval);
        }
      }, 200);
    }

    // Si el usuario no ha dicho si quiere ser notificado o no
    // Nota: debido a Chrome, no estamos seguros de que la propiedad de permiso
    // esté configurada, por lo tanto, no es seguro verificar el valor
    // "predeterminado" (default).
    else if (window.Notification && Notification.permission !== "denied") {
      Notification.requestPermission(function (status) {
        // Si el usuario dijo que está bien
        if (status === "granted") {
          var i = 0;
          // El uso de un intervalo hace que algunos navegadores (incluido
          // Firefox) bloqueen las notificaciones si hay demasiadas en un tiempo
          // determinado.
          var interval = window.setInterval(function () {
            // Gracias a la etiqueta, solo deberíamos ver la notificación "¡Hola! 9"
            var n = new Notification("¡Hola! " + i, {
              tag: "soManyNotification",
            });
            if (i++ == 9) {
              window.clearInterval(interval);
            }
          }, 200);
        }

        // De lo contrario, podemos recurrir a una alerta modal regular.
        else {
          alert("¡Hola!");
        }
      });
    }

    // Si el usuario rechaza a ser notificado.
    else {
      // Podemos recurrir a una alerta modal regular
      alert("¡Hola!");
    }
  });
});

• Notification