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

CKTIS / JavaScript

Composants de l’URL de la page : origin, pathname, search, hash et href

L’objet window.location expose l’URL complète de la page actuelle et ses composants. Découvrez les différences entre origin, pathname, search, hash et href, ainsi que les raisons pour lesquelles une écriture dans Location peut déclencher une navigation.

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

window.location est un objet Location associé au document actuel ; il est également accessible via document.location. Ses propriétés décrivent l’URL de la page et renvoient des chaînes de caractères. Il s’agit d’une API Web du navigateur, et non d’une fonctionnalité d’ECMAScript lui-même. La présence de Node 24 dans un dépôt ne prouve pas que le Location du navigateur est pris en charge.

Location.origin est en lecture seule. Pour HTTP(S), il contient le schéma, //, le nom d’hôte et le port s’il n’est pas celui par défaut ; il ne contient pas le chemin. Pour file:, le résultat dépend du navigateur : ne généralisez donc pas les règles HTTP(S) à tous les schémas. Location.pathname contient le chemin sans la requête ni le fragment ; pour HTTP(S), il commence par /.

Location.search renvoie la requête non vide avec son ? initial. Si la requête est absente ou vide, la propriété renvoie "", y compris lorsque l’URL se termine par un ? seul. La lecture ne décode pas les séquences en pourcentage : %20 reste %20. Utilisez new URLSearchParams(window.location.search) pour lire les paramètres individuellement. Location.hash renvoie le fragment non vide avec son # initial. Si le fragment est absent ou vide, la propriété renvoie "", y compris lorsque l’URL se termine par un # seul. Location.href renvoie l’URL entière, avec la requête et le fragment.

La lecture de ces propriétés ne modifie pas la page, mais écrire dans href déclenche une navigation. Modifier pathname ou search peut également charger un document ; modifier uniquement hash correspond généralement à une navigation dans le même document. Pour examiner une adresse quelconque en toute sécurité, utilisez URL plutôt que de modifier window.location. L’exemple utilise un objet URL distinct avec des noms de propriétés correspondants : son résultat est fixe et il ne redirige pas la page. Il ne teste pas le comportement de navigation de Location.

Exemples

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]}`);
}

Résultat

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

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