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

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.

Fontes