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