KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URL-onderdelen van de pagina: origin, pathname, search, hash en href

Het object window.location geeft toegang tot de volledige URL van de huidige pagina en de onderdelen ervan. Ontdek hoe origin, pathname, search, hash en href van elkaar verschillen en waarom schrijven naar Location navigatie kan starten.

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.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location is een Location-object dat bij het huidige document hoort; het is ook beschikbaar als document.location. De eigenschappen beschrijven de URL van de pagina en geven tekenreeksen terug. Dit is een browser-Web-API, geen functie van ECMAScript zelf. De aanwezigheid van Node 24 in een repository bewijst niet dat de Location van de browser wordt ondersteund.

Location.origin is alleen-lezen. Voor HTTP(S) bevat het het schema, //, de hostnaam en de poort als die niet standaard is; het pad ontbreekt. Bij file: hangt het resultaat af van de browser. Pas de regels voor HTTP(S) dus niet zonder meer toe op alle schema’s. Location.pathname bevat het pad zonder query of fragment; bij HTTP(S) begint het met /.

Location.search geeft een niet-lege query terug met een ? ervoor. Als de query ontbreekt of leeg is, geeft de eigenschap "" terug, ook als de URL op een losse ? eindigt. Bij het uitlezen worden procentreeksen niet gedecodeerd: %20 blijft %20. Gebruik new URLSearchParams(window.location.search) om afzonderlijke parameters uit te lezen. Location.hash geeft een niet-leeg fragment terug met een # ervoor. Als het fragment ontbreekt of leeg is, geeft de eigenschap "" terug, ook als de URL op een losse # eindigt. Location.href geeft de volledige URL terug, inclusief query en fragment.

Het uitlezen van deze eigenschappen verandert de pagina niet, maar schrijven naar href start een navigatie. Een wijziging van pathname of search kan ook een document laden; alleen hash wijzigen betekent meestal navigatie binnen hetzelfde document. Gebruik URL om een willekeurig adres veilig te onderzoeken, in plaats van window.location aan te passen. Het voorbeeld gebruikt een afzonderlijk URL-object met overeenkomstige eigenschapsnamen: de uitvoer staat vast en de pagina wordt niet omgeleid. Het is geen test van het navigatiegedrag van Location.

Voorbeelden

const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
  console.log(`${key}: ${url[key]}`);
}

Resultaat

origin: https://example.org:8443
pathname: /docs/start
search: ?q=web%20api
hash: #intro
href: https://example.org:8443/docs/start?q=web%20api#intro

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