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