Saltar al contenido
JavaScript en el navegador

Navegación e historial

Lección 9 de 1410 min3 ejercicios

En una aplicación de una sola página (SPA), pasar de "inicio" a "producto 7" no recarga nada: JavaScript cambia el contenido y la URL. Para que el botón "atrás", los marcadores y los enlaces compartidos sigan funcionando, el historial del navegador tiene que enterarse. De eso se encargan la History API y su sucesora, la Navigation API.

La History API

// Cambia la URL y agrega una entrada al historial, sin recargar
history.pushState({ productoId: 7 }, "", "/productos/7");
mostrarProducto(7);

// Cambia la URL actual, sin agregar una entrada (por ejemplo, al aplicar un filtro)
history.replaceState({ ...history.state, orden: "precio" }, "", "/productos/7?orden=precio");

// Cuando el usuario va atrás o adelante entre tus entradas
window.addEventListener("popstate", (e) => {
  mostrarSegun(location.pathname, e.state);
});
  • pushState(estado, "", url): nueva entrada. El estado es un objeto que te devuelven en popstate.
  • replaceState: reemplaza la entrada actual.
  • popstate: se dispara al moverse por el historial. No se dispara con tus propios pushState.
  • history.back(), forward() y go(n) mueven el historial desde el código.

La URL nueva tiene que ser del mismo origen: no puedes “disfrazar” tu página con la dirección de otro sitio.

El problema: hay que interceptar a mano cada clic en tus enlaces (con delegación de eventos), llamar a pushState, y además escuchar popstate para atrás y adelante. Son dos caminos para la misma idea.

La Navigation API

La Navigation API, disponible en los navegadores modernos, une todo en un solo evento, navigate, que se dispara con cualquier navegación: enlaces, envíos de formularios, atrás y adelante, y las que hagas desde el código.

navigation.addEventListener("navigate", (evento) => {
  if (!evento.canIntercept || evento.hashChange || evento.downloadRequest) return;

  const url = new URL(evento.destination.url);
  if (url.pathname.startsWith("/productos/")) {
    evento.intercept({
      async handler() {
        const id = url.pathname.split("/").pop();
        const producto = await cargarProducto(id);
        mostrarProducto(producto);
      },
    });
  }
});

// Navegar desde el código
navigation.navigate("/productos/7");

Con intercept, el navegador cambia la URL y el historial por ti, y tu handler muestra el contenido. Mientras el handler corre, el navegador muestra que la página “está cargando” y, si el usuario navega a otro lado, cancela la navegación en curso (con la señal evento.signal). Además, navigation.entries() lista el historial de tu aplicación y navigation.currentEntry dice dónde estás.

Lo que necesita el servidor

Si alguien guarda https://tienda.com/productos/7 y la abre más tarde, el navegador se la pide al servidor. Si el servidor solo conoce /, responderá 404. Hay dos soluciones:

  • Configurar el servidor para que responda la página principal en todas las rutas de la aplicación (y que JavaScript muestre lo que corresponde).
  • Generar una página HTML por cada ruta, por adelantado o en el servidor. Es lo que hacen frameworks como Astro, con el que está hecho este sitio.

Resumen

  • pushState y replaceState cambian la URL sin recargar; popstate avisa de atrás y adelante.
  • Solo se puede cambiar a URLs del mismo origen.
  • La Navigation API une todo en el evento navigate; intercept deja que tu código lo maneje.
  • Cada ruta de la aplicación tiene que funcionar también al abrirse directamente desde el servidor.

¡A practicar!

Tu progreso se guarda en este navegador.

domina-js · JavaScript en español, gratis y paso a paso.