Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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 = path

URL.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.

Fuentes