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.hrefwindow.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.