Parser de Query String de URL
A query string é a parte de uma URL que vem após o caractere '?', formada por pares chave=valor separados por '&'. Esta ferramenta utiliza a API URLSearchParams do navegador para analisar qualquer URL ou query string bruta, decodificando automaticamente os valores percentuais para exibir os parâmetros em uma tabela clara.
Você também pode usar o modo inverso: adicione quantas linhas de chave/valor quiser e a ferramenta gerará instantaneamente uma query string corretamente codificada, pronta para ser anexada a qualquer URL. Isso é essencial ao depurar requisições de API, construir links de redirecionamento ou inspecionar parâmetros de rastreamento em URLs de marketing.
Como funciona
Análise: extrai a parte após '?' e divide por '&'; cada segmento é dividido no primeiro '=' para obter chave e valor, ambos decodificados via decodeURIComponent(). Construção: usa URLSearchParams.append(chave, valor) para cada linha e adiciona '?' como prefixo.
Casos de uso
- Depurar requisições de API REST inspecionando parâmetros de URL
- Analisar parâmetros UTM em links de campanhas de marketing
- Construir URLs de redirecionamento com query strings dinâmicas
- Decodificar valores percentuais da barra de endereços do navegador
- Testar o tratamento de query strings no desenvolvimento de aplicações web
Perguntas frequentes
O que é uma query string em uma URL?
A query string é tudo o que vem depois do caractere '?' em uma URL, formada por pares chave=valor unidos por '&' — por exemplo, ?pagina=2&ordem=preco. Servidores e scripts do lado do cliente leem esses parâmetros para filtrar resultados, rastrear campanhas ou passar estado entre páginas. Esta ferramenta divide qualquer URL ou query string bruta em uma tabela decodificada de parâmetros.
Como decodificar %20 e outros caracteres codificados em uma URL?
A codificação percentual representa caracteres reservados ou não ASCII como % seguido do valor do byte em hexadecimal: %20 é espaço, %2F é '/' e %3D é '='. Em JavaScript, decodeURIComponent() reverte a codificação, exatamente o que este parser aplica a cada chave e valor. Vale lembrar que, em query strings, o '+' também costuma ser interpretado como espaço.
O que é a API URLSearchParams?
URLSearchParams é uma API nativa do navegador para ler e construir query strings. Ela oferece métodos como get(), getAll(), append() e toString(), tratando a codificação percentual automaticamente. Esta ferramenta a utiliza internamente tanto para analisar a string colada quanto para montar uma query string corretamente codificada a partir das suas linhas de chave/valor.
Uma query string pode ter a mesma chave repetida?
Sim — chaves repetidas são válidas e comuns, por exemplo ?tag=vermelho&tag=azul. A interpretação depende do servidor: alguns frameworks retornam um array de valores, outros mantêm apenas a primeira ou a última ocorrência. A URLSearchParams expõe todas as ocorrências via getAll(), e este parser lista cada par repetido em sua própria linha.
O que são parâmetros UTM em uma URL?
Parâmetros UTM são chaves padronizadas de query string usadas por ferramentas de analytics para atribuir tráfego: utm_source, utm_medium, utm_campaign, utm_term e utm_content. Por exemplo, ?utm_source=newsletter&utm_medium=email identifica visitas vindas de uma campanha de e-mail. Colar um link de campanha neste parser mostra cada valor UTM decodificado e fácil de auditar.