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

CKTIS / JavaScript

URL.pathname — lire et modifier le chemin

URL.pathname permet de lire ou de remplacer le chemin d’une URL sans modifier sa requête ni son fragment.

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

url.pathname
url.pathname = path

URL.pathname est une propriété d’instance de URL, et non une propriété statique du constructeur. Elle renvoie le chemin sérialisé, sans la requête ni le fragment. Pour une URL HTTPS sans segment de chemin, elle renvoie /.

Une affectation remplace le chemin tout en conservant search et hash. Les espaces deviennent %20 ; la lecture ne décode pas automatiquement les séquences encodées en pourcentage. Modifier l’objet ne déclenche pas de navigation dans le navigateur.

Les chemins opaques, comme celui de mailto:person@example.org, peuvent être lus, mais une affectation à pathname est ignorée.

Exemples

const url = new URL('https://example.org/docs/start?q=1#intro');
console.log(url.pathname);
url.pathname = '/learn JavaScript';
console.log(url.pathname);
console.log(url.href);

Résultat

/docs/start
/learn%20JavaScript
https://example.org/learn%20JavaScript?q=1#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