Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes