CKTIS / JavaScript
hashchange — cambios del fragmento de URL en Window
El evento hashchange de window informa de un cambio del fragmento de URL durante la navegación dentro del mismo documento. Proporciona las URL anterior y nueva, pero llamar a pushState() o replaceState() no lo activa por sí solo.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
window.addEventListener("hashchange", handler);
window.removeEventListener("hashchange", handler);hashchange es un evento de la API Web en window, no una parte de ECMAScript. Informa de un cambio del fragmento de URL durante la navegación dentro del mismo documento, por ejemplo, después de asignar otro valor a location.hash, seguir un enlace con fragmento o avanzar y retroceder entre entradas pertinentes del historial.
Registra una función con window.addEventListener("hashchange", handler). Su HashChangeEvent tiene las propiedades oldURL y newURL, que contienen las URL completas antes y después del cambio. El evento se entrega de forma asíncrona. Lee estas propiedades cuando necesites las URL de ese cambio concreto.
Llamar a history.pushState() o history.replaceState() no activa por sí solo hashchange, aunque cambie el fragmento. Volver a establecer el mismo fragmento tampoco constituye un cambio. No trates este evento como una notificación de todos los cambios de URL ni como la inicialización de la vista durante la primera carga de la página.
El ejemplo elige un fragmento distinto y escucha un solo evento mediante { once: true }. Compara los fragmentos obtenidos de las URL del evento, por lo que los resultados esperados no dependen de la URL inicial de la página. Necesita un entorno de navegador; la versión de Node.js del repositorio no demuestra que esta API sea compatible.
Ejemplos
(() => {
const target = location.hash === "#cktis-a" ? "#cktis-b" : "#cktis-a";
window.addEventListener("hashchange", (event) => {
const before = new URL(event.oldURL);
const after = new URL(event.newURL);
console.log(before.hash !== after.hash);
console.log(after.hash === target);
}, { once: true });
location.hash = target;
})();Resultado
true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.