Resolver URL relativa com uma URL base

Informe uma URL base absoluta e a referência encontrada em documento, feed, folha de estilos, manifesto ou resposta de API. O resolvedor aplica o padrão a segmentos, barras finais, queries, fragmentos, portas e mudanças de origem, entregando uma URL normalizada sem acessar o destino nem examinar conteúdo remoto. O processo é rápido e determinístico.

Comece pela URL completa que fornece o contexto

Uma referência relativa só tem significado em relação a outra URL. Informe esse contexto em base_url como uma URL absoluta completa, incluindo esquema e host quando o esquema exigir um host. O caminho é tão importante quanto o domínio. Por exemplo, uma base terminada em <code>/docs/page.html</code> trata uma referência simples como <code>image.png</code> como irmã da página, enquanto uma base terminada em <code>/docs/</code> a trata como filha desse diretório. O resolvedor não tenta adivinhar se o caminho representa arquivo ou pasta; ele segue a sintaxe, principalmente a barra final. São aceitas as formas absolutas padrão reconhecidas pela implementação URL do navegador. Um valor como <code>/docs/page.html</code> não serve como base porque não contém esquema absoluto nem contexto de origem. Bases inválidas ou relativas geram erro de entrada, em vez de uma resposta que apenas parece correta. Essa rigidez revela problemas antes que links resolvidos cheguem a um crawler, uma importação, uma regra de redirecionamento ou um conjunto de dados persistido.

Entenda como cada referência altera a base

O campo relative_reference aceita mais do que um nome de arquivo. Uma barra inicial substitui o caminho base, mas mantém esquema e autoridade. Duas barras iniciais criam uma referência de rede, permitindo trocar o host e herdar o esquema. Segmentos como <code>../</code> sobem níveis, enquanto <code>./</code> permanece no nível atual; a normalização remove esses segmentos de navegação da URL final. Uma referência iniciada por <code>?</code> preserva o caminho e substitui a query. Quando começa por <code>#</code>, preserva caminho e query e altera o fragmento. Uma referência totalmente absoluta substitui a base, conforme determina o padrão. Esta capacidade rejeita referências vazias para não confundir um campo ausente por engano com a reutilização intencional da base. Caracteres codificados por porcentagem continuam codificados conforme as regras de serialização, enquanto hosts, portas padrão e outros componentes podem ser normalizados para a forma canônica produzida pelo analisador padrão.

Use o resultado serializado sem fazer uma requisição

O resultado contém absolute_url, a URL normalizada e serializada depois da resolução. Nenhuma consulta DNS, requisição HTTP, verificação de disponibilidade, descarga ou sequência de redirecionamentos é executada. Essa separação ajuda quando você precisa de uma transformação determinística, e não de um teste do site em tempo real: as mesmas duas entradas sempre produzem a mesma saída, mesmo que o host não exista ou o recurso seja privado. Use o resultado para normalizar links extraídos de HTML, preparar filas de crawling, expandir referências em feeds, validar fixtures, montar entradas de sitemap ou comparar URLs de maneira uniforme antes da deduplicação. A resolução sintática não comprova que o destino seja seguro, acessível, público ou autorizado. Se os valores vierem de usuários não confiáveis, aplique as políticas de esquema, host e acesso à rede do seu aplicativo antes de buscar a URL devolvida. A API e o executor do navegador usam o mesmo algoritmo puro. Cada requisição de API custa US$ 0,002; a execução local nesta página é gratuita.