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

CKTIS / JavaScript

Location : fragment, origine, chemin, requête et URL complète

Lisez les cinq propriétés de l’URL d’un document et distinguez les affectations susceptibles de déclencher une navigation.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location renvoie l’objet Location associé au document. Il relève d’une API Web du navigateur, pas d’ECMAScript 2024. L’objet reflète l’URL courante du document, mais une chaîne lue auparavant ne se met pas à jour. Utilisez new URL(window.location.href) pour examiner ou modifier une URL séparée sans naviguer.

href est l’URL complète sérialisée. pathname ne contient que le chemin, sans requête ni fragment. Avec HTTP(S), il commence par /, y compris à la racine. Un chemin opaque comme blank dans about:blank peut ne pas commencer par une barre oblique. search renvoie une requête non vide précédée de ?, et hash un fragment non vide précédé de #. Si le composant est absent ou vide, la propriété vaut "", même si le séparateur figure encore dans href. La lecture ne décode pas les séquences encodées en pourcentage. Pour lire les paramètres de requête, utilisez new URLSearchParams(window.location.search).

origin est en lecture seule et décrit l’origine de l’URL. Avec HTTP(S), la chaîne comprend le schéma, le nom d’hôte et le port s’il n’est pas celui par défaut. Une origine d’URL opaque donne la chaîne "null", et non la valeur null. À l’inverse, self.origin décrit l’origine de l’environnement d’exécution : un document about:blank peut en hériter. Deux chaînes "null" ne prouvent pas que les origines sont identiques.

Affecter une valeur à href peut déclencher une navigation vers une autre URL, même relative. Si l’analyse échoue, une DOMException nommée SyntaxError est levée. Affecter pathname ou search peut déclencher une navigation avec un chemin ou une requête modifiés. L’affectation à pathname est sans effet si le chemin est opaque. Les préfixes ? et # sont facultatifs à l’écriture de search et hash, respectivement. search = "" supprime la requête, mais hash = "" peut laisser un # final. Modifier seulement le fragment ne charge généralement pas de nouveau document.

Lire l’une de ces cinq propriétés dans une fenêtre d’origine différente peut lever une DOMException nommée SecurityError. L’écriture de href fait exception : elle peut être autorisée sans accès en lecture, mais les restrictions de navigation du navigateur s’appliquent toujours.

Exemples

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Résultat

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Exécutez le code dans Node.js. Il lit les mêmes composants de l’URL dans un objet `URL`, et non dans un objet `Location` du navigateur, sans déclencher de navigation. Dans le résultat, `"null"` est une chaîne et `blank` ne commence pas par `/`.

Leçons associées

  • JavaScript · Leçon 38 · Avancé · Version : 4

Sources