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. Elestadoes un objeto que te devuelven enpopstate.replaceState: reemplaza la entrada actual.popstate: se dispara al moverse por el historial. No se dispara con tus propiospushState.history.back(),forward()ygo(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
pushStateyreplaceStatecambian la URL sin recargar;popstateavisa de atrás y adelante.- Solo se puede cambiar a URLs del mismo origen.
- La Navigation API une todo en el evento
navigate;interceptdeja 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.