Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Location.href — lire l’adresse et naviguer

Location.href expose l’URL du document sous forme de chaîne de caractères. L’affectation d’une valeur déclenche une navigation, au lieu de simplement modifier une variable ordinaire.

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

Syntaxe

window.location.href
window.location.href = url

Location.href est une propriété de l’API du navigateur, accessible via window.location.href. Sa lecture renvoie l’URL sérialisée du document, y compris sa requête et son fragment, s’ils sont présents.

L’affectation window.location.href = url déclenche une navigation. Lors de l’affectation, une adresse relative est résolue par rapport à l’URL de base de l’API de l’objet de paramètres d’entrée (entry settings object). Lors d’un appel synchrone entre cadres, il peut s’agir de l’URL de base du cadre à l’origine de l’appel plutôt que de celle du cadre dont le code effectue l’affectation. Une adresse invalide peut provoquer une DOMException de type SyntaxError.

La lecture de l’adresse d’une autre fenêtre est soumise aux restrictions liées à l’origine et peut provoquer une SecurityError. L’exemple ne fait que lire l’adresse ; il ne quitte pas la page.

Exemples

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

Résultat

string
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources