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

CKTIS / JavaScript

`URL.origin`, `URL.pathname` e `URL.search`

Distingue a origem, o caminho e a cadeia de consulta de um URL analisado e lê parâmetros individuais sem dividir o endereço manualmente.

Versão: Current web platform; runtime support varies

Sintaxe

const url = new URL(input);
const resolved = new URL(input, base);

url.origin;
url.pathname;
url.search;

url.pathname = "/catalog";
url.search = "page=2";

origin, pathname e search são propriedades de uma instância de URL, não métodos. URL é uma API da plataforma Web e não faz parte do ECMAScript 2024, por isso confirma que o teu ambiente de execução a disponibiliza. Usa new URL(input) para um URL absoluto e fornece uma base adequada com new URL(input, base) para uma referência relativa. Se a base fornecida for inválida ou a análise falhar, o construtor lança TypeError. Alterar o objeto URL não desencadeia uma navegação.

origin é só de leitura. Para HTTP(S), contém o esquema e o nome do anfitrião, bem como a porta se não for a predefinida. Não inclui credenciais, caminho, consulta nem fragmento. Uma origem opaca, como a de um URL data:, é serializada como a cadeia "null", não como o valor null. Duas cadeias iguais deste tipo não provam que a origem é a mesma. O resultado para file: depende da implementação.

pathname é o caminho serializado, sem consulta nem fragmento. Em HTTP(S), começa por / e o caminho raiz é /. As sequências com codificação percentual, como %20, não são descodificadas automaticamente. Podes atribuir um novo caminho HTTP(S). Outros esquemas podem ter um caminho opaco sem / inicial.

search devolve a cadeia de consulta com o ? inicial, sem o fragmento e sem descodificar sequências percentuais. Devolve "" se a consulta estiver ausente ou vazia, mesmo quando só há um ?. Podes atribuir uma nova consulta com ou sem o ? inicial; atribuir "" remove-a.

Usa url.searchParams.get("q") para ler o valor descodificado de um parâmetro. Alterar searchParams atualiza o mesmo objeto URL e pode mudar a serialização dos valores existentes: um espaço escrito como %20 pode passar a +. Usa href para ler o URL completo, incluindo o fragmento.

Exemplos

{
  const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
  console.log(url.origin);
  console.log(url.pathname);
  console.log(url.search);
  console.log(url.searchParams.get("q"));

  url.searchParams.set("page", "2");
  console.log(url.href);
}

Resultado

https://shop.example
/catalog/tea%20sets
?q=green%20tea
green tea
https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews

A normalização remove a porta predefinida `443` e o segmento de caminho `.`. `search` mantém `%20`, `get("q")` devolve um valor com um espaço e, ao adicionar `page=2`, esse espaço passa a ser representado como `+` na consulta.

Lições relacionadas

  • JavaScript · Lição 38 · Avançado · Versão: 4

Fontes