CKTIS / JavaScript
URL.pathname — leer y cambiar la ruta
URL.pathname permite leer o sustituir la ruta de una URL sin cambiar su consulta ni su fragmento.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
url.pathname
url.pathname = pathURL.pathname es una propiedad de instancia de URL, no una propiedad estática del constructor. Devuelve la ruta serializada sin la consulta ni el fragmento. En una URL HTTPS sin segmentos de ruta, devuelve /.
La asignación sustituye la ruta y conserva search y hash. Los espacios se convierten en %20; al leer, no se decodifican automáticamente las secuencias codificadas en porcentaje. Cambiar el objeto no hace que el navegador navegue.
Las rutas opacas, como la de mailto:person@example.org, se pueden leer, pero se ignora la asignación a pathname.
Ejemplos
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);Resultado
/docs/start /learn%20JavaScript https://example.org/learn%20JavaScript?q=1#intro
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.