KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Location.href — het adres lezen en navigeren

Location.href geeft de URL van het document als tekenreeks. Een waarde toewijzen start een navigatie, in plaats van alleen een gewone variabele te wijzigen.

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.href
window.location.href = url

Location.href is een eigenschap van de browser-API die toegankelijk is via window.location.href. Bij het uitlezen wordt de geserialiseerde URL van het document teruggegeven, inclusief de query en het fragment als die aanwezig zijn.

De toewijzing window.location.href = url start een navigatie. De setter lost een relatief adres op ten opzichte van de API-basis-URL van het instellingsobject van het ingangspunt (entry settings object). Bij een synchrone aanroep tussen frames kan dat de basis-URL zijn van het frame dat de aanroep heeft gestart, en niet die van het frame waarvan de code de toewijzing uitvoert. Een ongeldig adres kan een SyntaxError-DOMException veroorzaken.

Het uitlezen van het adres van een ander venster is onderworpen aan beperkingen op basis van de origin en kan een SecurityError veroorzaken. Het voorbeeld leest alleen het adres uit; de pagina wordt niet verlaten.

Voorbeelden

const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());

Resultaat

string
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