Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

hashchange — zmiana fragmentu adresu w Window

Zdarzenie hashchange na window informuje o zmianie fragmentu URL podczas nawigacji w obrębie dokumentu. Udostępnia poprzedni i nowy adres, ale nie jest wywoływane przez samo pushState() ani replaceState().

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

window.addEventListener("hashchange", handler);
window.removeEventListener("hashchange", handler);

hashchange to zdarzenie Web API na window, a nie element samego ECMAScript. Sygnalizuje zmianę fragmentu URL podczas nawigacji w obrębie dokumentu, np. po przypisaniu innej wartości do location.hash, użyciu odnośnika z fragmentem lub przejściu Wstecz/Dalej między odpowiednimi wpisami historii.

Zarejestruj funkcję przez window.addEventListener("hashchange", handler). Otrzymany HashChangeEvent ma właściwości oldURL i newURL, zawierające pełne adresy przed zmianą i po niej. Zdarzenie jest dostarczane asynchronicznie; odczytuj te właściwości, gdy potrzebujesz adresów konkretnej zmiany.

Samo wywołanie history.pushState() lub history.replaceState() nie emituje hashchange, nawet jeśli zmienia fragment. Ponowne ustawienie identycznego fragmentu również nie stanowi zmiany. Nie traktuj tego zdarzenia jako powiadomienia o każdej zmianie URL ani jako inicjalizacji widoku przy pierwszym wczytaniu strony.

Przykład wybiera inny fragment i nasłuchuje tylko jednego zdarzenia dzięki { once: true }. Porównuje fragmenty uzyskane z adresów zdarzenia, dlatego oczekiwane wyniki nie zależą od początkowego adresu strony. Wymaga środowiska przeglądarki; wersja Node.js w repozytorium nie potwierdza obsługi tego API.

Przykłady

(() => {
  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;
})();

Wynik

true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła