A referência usada para completar o endereço
Uma URL base é um endereço completo usado para resolver uma referência relativa, como artigos ou ../imagens/logo.png. A resolução interpreta a estrutura da base e os segmentos da referência para produzir o endereço completo do destino.
O JavaScript permite fazer essa resolução com new URL(referencia, base). A barra final da base participa do cálculo: sem ela, o último segmento do caminho é substituído por uma referência ao diretório atual. Com a barra final, esse segmento permanece como parte do diretório.
Duas bases que produzem caminhos diferentes
Os exemplos abaixo usam a mesma referência artigos. A propriedade href permite consultar o endereço completo produzido pelo construtor.
new URL('artigos', 'https://exemplo.com/guias/').href// https://exemplo.com/guias/artigos
new URL('artigos', 'https://exemplo.com/guias').href// https://exemplo.com/artigosNo primeiro caso, o diretório da base é /guias/, por isso artigos fica dentro dele. A segunda base usa / como diretório e tem seu segmento guias substituído por artigos. Essa interpretação é feita pela estrutura da URL, sem verificar se guias corresponde a uma pasta ou a um arquivo no servidor.
Uma referência iniciada por uma única barra, como /artigos, parte da raiz da origem e preserva o protocolo e o domínio da base. Já ../artigos sobe um nível em relação ao diretório usado na resolução. Você pode conferir o destino calculado por href e depois testar a resposta do servidor, pois construir uma URL válida não confirma a existência do recurso.
Clientes de integração podem ter opções próprias para combinar endereços. Ao configurar uma URL base nessas bibliotecas, consulte o comportamento documentado e confira o endereço efetivamente enviado pela aplicação.
Dúvidas frequentes
Perguntas frequentes sobre URL base
- Resolver uma URL relativa equivale a concatenar duas strings?
- A resolução interpreta os segmentos do endereço. Uma referência iniciada por uma única barra / substitui o caminho da base. A sequência ../ sobe um nível a partir do diretório considerado na resolução.
- A base precisa corresponder a um diretório que existe no servidor?
- A resolução usa a estrutura do endereço, sem consultar o servidor. A URL resultante ainda precisa ser acessada para verificar se o recurso existe e pode ser utilizado.
- Uma URL absoluta também usa o caminho da base?
- No construtor URL do JavaScript, um endereço absoluto válido já fornece seu próprio destino. A base só é necessária para resolver uma referência relativa.
Para continuar
Recursos relacionados
Documentação
MDN: resolução de endereços relativos
Mostra como o construtor URL resolve referências a partir do diretório atual, do diretório superior ou da raiz.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Acompanhamento ao vivo para conferir os endereços construídos pela aplicação e investigar chamadas ao caminho errado.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A construção de endereços afeta os links e as chamadas que você precisa conferir ao desenvolver uma aplicação com agentes.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.