CKTIS / JavaScript
URL — analisar e modificar endereços
URL divide um endereço nos seus componentes, resolve referências relativas e permite modificar parâmetros de consulta.
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
new URL(url, base?)URL é uma API WHATWG, não ECMAScript. new URL(url, base?) analisa um endereço; as referências relativas requerem uma base. Se a análise falhar, é lançado um TypeError.
href expõe o endereço completo serializado, enquanto pathname expõe o respetivo caminho. Em HTTP(S), origin contém o esquema, o anfitrião e, se existir, a porta, mas não o caminho. Resolver relativamente a uma base não é uma concatenação: a / final é importante.
searchParams é um objeto URLSearchParams associado: as alterações feitas nele atualizam o endereço. Passa os valores sem os codificar previamente; os espaços são serializados como +. Uma análise bem-sucedida não significa que o endereço seja seguro — verifica se protocol e origin são permitidos.
Exemplos
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Resultado
/app/items https://example.com/app/items?q=red+shoes
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.