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 = urlLocation.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.