URL

Componentes

O que é o Analisador de URL?

Cole uma URL e a ferramenta quebra ela nas partes que realmente importam — protocolo, host, porta, caminho, parâmetros de query, hash. A saída é JSON, então você pode copiar direto para um fixture de teste, um log de debug, ou onde quer que precise dos componentes em forma estruturada. O parser segue o WHATWG URL Standard, que é o que todo navegador moderno usa internamente.

Por que um parser? Porque ler uma URL longa com cinco parâmetros de query codificados em porcentagem e um fragmento de hash é doloroso. O navegador já sabe fazer isso pela URL API, mas você não tem uma superfície rápida de cola-e-vê para isso. É isso aqui. Os parâmetros de query também são decodificados — %20 vira espaço, %5B vira [, chaves repetidas viram array — mesmo comportamento que o URLSearchParams.

Tudo roda no seu navegador. Sem upload, sem servidor, sem logs. Parsing de URL é determinístico — não tem IA, não tem chute, só o mesmo algoritmo que a RFC 3986 definiu e a spec WHATWG refinou.

Como usar o Analisador de URL

Três passos. Cada um corresponde a um botão nesta página.

Cole uma URL ou carregue o exemplo

Solte uma URL no painel da esquerda. Clique em Exemplo para carregar um caso realista com codificação porcentual, chaves de query repetidas e fragmento de hash. URL de exemplo:

https://api.shop.example.com/v1/orders?customer=Ava%20Chen&status=active&total%5Bgte%5D=49.99&page=2#summary

Qualquer coisa que o construtor URL aceitar funciona — incluindo <code>file://</code>, <code>mailto:</code>, esquemas customizados, hosts IPv6 e userinfo (<code>user:pass@host</code>).

Leia os componentes

O painel da direita mostra a URL parseada como JSON: protocol, host, port, pathname, pathSegments (o caminho dividido em array), searchParams (pares chave-valor decodificados, com arrays para chaves repetidas) e hash. Atualiza enquanto você digita.

Copie ou baixe

Clique em Copiar para mandar o JSON para a área de transferência, ou Baixar para salvar como arquivo .json. Minificar compacta o JSON em uma linha só, caso precise para uma linha de log. Use Limpar no painel de entrada para começar de novo.

Quando você vai usar isso de verdade

Debugar redirects e URLs de analytics

Uma URL com doze parâmetros de query vinda de um redirect de tracking de anúncio é ilegível na barra de endereço. Cole aqui para ver os parâmetros um por linha, decodificados, com o parâmetro url de destino totalmente desempacotado. Combina bem com a remoção de trackers no nosso URL Cleaner (quando sair).

Inspecionar URLs de webhook e callback OAuth

Callbacks OAuth e payloads de webhook entopem a query string com estado. Separar tudo deixa óbvio se o token state sumiu, se o code foi truncado, ou se o redirect_uri está codificado duas vezes. A RFC 6749 exige esses parâmetros e isso aqui revela todos eles de uma vez.

Montar fixtures de teste

Quando você está escrevendo testes contra uma URL, geralmente quer ela como objeto estruturado, não string. Cole a URL, copie o JSON, jogue no seu arquivo de fixture. Te poupa de digitar protocol: 'https:' à mão pela quinta vez no dia.

Conferência sanity de tickets de suporte

"Quebrou quando cliquei nesse link" — o link tem 400 caracteres com barras codificadas duas vezes. O parser mostra exatamente o que o navegador veria, incluindo se %252F significa um %2F literal ou um separador de caminho que foi codificado duas vezes ao passar por um proxy.

Perguntas frequentes

Funciona com URLs relativas?

Não — o construtor URL precisa de uma URL absoluta (com um protocolo como https:// ou file://). Para URLs relativas, prefixe uma base como https://example.com e depois remova do resultado. A spec WHATWG descreve a forma de dois argumentos (new URL(relative, base)) usada internamente pelos navegadores.

Como ele lida com chaves de query repetidas?

Chaves repetidas se juntam em um array. Então ?tag=red&tag=blue vira "tag": ["red", "blue"] na saída. Bate com como a maioria dos frameworks de servidor (Express, FastAPI, ASP.NET) parseiam query strings.

E a notação de array com colchetes tipo ?items[]=1&items[]=2?

O parser trata os colchetes como parte da chave — então você verá "items[]": ["1", "2"]. É honesto com os bytes que vão pelo fio. Se precisa de um decodificador específico de framework (PHP, Rails, qs.js), faça o pós-processamento na saída parseada.

É seguro colar credenciais em URLs (user:pass@host) aqui?

O parsing acontece inteiramente no seu navegador — a URL nunca sai da sua máquina. Dito isso, colocar credenciais numa URL é geralmente desencorajado (a RFC 3986 §3.2.1 aponta os riscos de segurança), e a maioria dos navegadores remove silenciosamente. Se colar uma, os campos username e password aparecem na saída.

Lida com nomes de domínio internacionalizados (IDNs)?

O construtor URL do navegador lida com domínios IDN, mas a saída pode mostrar a forma Punycode (xn--...) em vez da forma Unicode. É assim que a URL seria realmente enviada pelo fio. Se precisar converter entre as duas, uma ferramenta dedicada de Punycode chega nesta seção em breve.

Por que a saída se chama "Componentes" e não "JSON"?

É JSON sim — mas o enquadramento importa. A saída são as partes da URL, estruturadas. Se você tratar a página como "conversor URL → JSON", perde o ponto: o valor está no desmembramento, não no formato.

Outras ferramentas de URL e JSON

Parsing é uma operação. Aqui vai o que combina naturalmente com isso: