KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

hashchange — wijzigingen van het URL-fragment in Window

Het hashchange-gebeurtenis op window meldt een wijziging van het URL-fragment tijdens navigatie binnen hetzelfde document. Het levert de vorige en nieuwe URL, maar een aanroep van pushState() of replaceState() activeert het niet zelf.

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

Syntax

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

hashchange is een Web API-gebeurtenis op window en geen onderdeel van ECMAScript zelf. Het meldt een wijziging van het URL-fragment tijdens navigatie binnen hetzelfde document, bijvoorbeeld nadat een andere waarde aan location.hash is toegewezen, bij het volgen van een fragmentlink of bij het terug- of vooruitgaan tussen relevante geschiedenisitems.

Registreer een functie met window.addEventListener("hashchange", handler). De HashChangeEvent heeft de eigenschappen oldURL en newURL, met de volledige URL’s vóór en na de wijziging. De gebeurtenis wordt asynchroon afgeleverd. Lees deze eigenschappen wanneer je de URL’s van die specifieke wijziging nodig hebt.

Een aanroep van history.pushState() of history.replaceState() activeert hashchange niet zelf, ook niet als hierdoor het fragment verandert. Hetzelfde fragment opnieuw instellen is evenmin een wijziging. Zie deze gebeurtenis niet als melding van elke URL-wijziging of als initialisatie van de weergave bij het laden van de pagina.

Het voorbeeld kiest een ander fragment en luistert met { once: true } naar slechts één gebeurtenis. Het vergelijkt de fragmenten die uit de gebeurtenis-URL’s zijn gehaald, zodat de verwachte resultaten niet afhangen van de oorspronkelijke URL van de pagina. Er is een browseromgeving nodig; de Node.js-versie van de repository toont niet aan dat deze API wordt ondersteund.

Voorbeelden

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

Resultaat

true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen