KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Location.hash en Location.href: fragment of volledige URL

`Location.hash` leest of wijzigt het URL-fragment. `Location.href` geeft de volledige URL terug of vraagt navigatie naar een bestemming aan.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;

window.location geeft toegang tot het Location-object van het document. Dit is een browser-API uit de HTML-standaard, geen onderdeel van ECMAScript 2024. Ga er niet van uit dat deze API buiten een browservenster beschikbaar is.

Bij het lezen geeft hash een niet-leeg fragment terug met een # ervoor, zonder procentcodering te decoderen. Als het fragment ontbreekt of leeg is, krijg je "". href geeft de volledige URL terug als tekenreeks, inclusief de query en het fragment als die aanwezig zijn. href kan eindigen op een losse #, terwijl hash toch "" is.

Een toewijzing aan hash wijzigt alleen het fragment; de eerste # is optioneel. Als het resulterende fragment gelijk blijft, vindt er geen navigatie plaats. Met "" stel je een leeg fragment in, in plaats van het fragment weg te halen. Als navigatie binnen hetzelfde document het fragment wijzigt, wordt hashchange geactiveerd zonder het document te herladen.

Een toewijzing aan href geeft een navigatiebestemming op. Een relatieve URL wordt opgelost ten opzichte van de basis-URL van de aanroepende omgeving. Als het parsen mislukt, werpt de browser een DOMException met de naam SyntaxError. Originregels beperken het lezen van beide eigenschappen en het schrijven naar hash. Schrijven naar href kan tussen verschillende origins zijn toegestaan, maar navigatiebeperkingen blijven gelden.

Voorbeelden

(async () => {
  const show = address => console.log(JSON.stringify([address.hash, address.href]));

  if (typeof document === 'undefined') {
    // Node.js: URL serialization only, without navigation or hashchange.
    const url = new URL('about:blank');
    show(url);
    url.hash = 'details';
    show(url);
    url.href = 'about:blank#summary';
    show(url);
    return;
  }

  const frame = document.createElement('iframe');
  frame.hidden = true;
  document.body.append(frame);

  try {
    const child = frame.contentWindow;
    const location = child.location;
    const nextHashChange = () => new Promise(resolve => {
      child.addEventListener('hashchange', resolve, { once: true });
    });

    show(location);
    const firstChange = nextHashChange();
    location.hash = 'details';
    await firstChange;
    show(location);

    const secondChange = nextHashChange();
    location.href = 'about:blank#summary';
    await secondChange;
    show(location);
  } finally {
    frame.remove();
  }
})();

Resultaat

["","about:blank"]
["#details","about:blank#details"]
["#summary","about:blank#summary"]

Voer de code uit in de console van een gewone, volledig geladen HTTP(S)-pagina die een iframe zonder `sandbox`-beperkingen toestaat. Elke regel toont `[hash, href]`. Beide toewijzingen wijzigen de URL van het iframe, niet die van de bovenliggende pagina. In Node.js gebruikt het voorbeeld een `URL`-object in plaats van `Location` om alleen URL-serialisatie te tonen, zonder navigatie of `hashchange`-gebeurtenissen.

Gerelateerde lessen

  • JavaScript · Les 30 · Gevorderd · Versie: 4

Bronnen