CKTIS / JavaScript
URL.pathname — ler e alterar o caminho
URL.pathname permite ler ou substituir o caminho de um URL sem alterar a consulta nem o fragmento.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
url.pathname
url.pathname = pathURL.pathname é uma propriedade de instância de URL, não uma propriedade estática do construtor. Devolve o caminho serializado sem a consulta nem o fragmento. Num URL HTTPS sem segmentos de caminho, devolve /.
A atribuição substitui o caminho, preservando search e hash. Os espaços passam a %20; a leitura não descodifica automaticamente sequências codificadas em percentagem. Alterar o objeto não faz com que o navegador navegue.
Os caminhos opacos, como o de mailto:person@example.org, podem ser lidos, mas a atribuição a pathname é ignorada.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.