Conversor de query string para JSON

Uma query string é fácil de reconhecer, mas torna-se difícil de inspecionar quando contém caracteres codificados, valores vazios, filtros repetidos e sinalizadores específicos de uma aplicação. Ele decodifica escapes percentuais como UTF-8, interpreta sinais de mais como espaços, mantém valores vazios visíveis e representa nomes de parâmetros repetidos como listas na ordem original. A transformação é determinística e adequada para analisar requisições, montar dados de teste, revisar logs e desenvolver ferramentas internas.

Transforme parâmetros compactos em um objeto fácil de inspecionar

Query strings foram criadas para transportar dados, não para oferecer uma leitura confortável. Um navegador ou cliente pode enviar em uma única linha compacta um termo de busca, várias etiquetas selecionadas, um campo opcional vazio e uma localização com caracteres internacionais. Um parâmetro escrito sem sinal de igual é mantido com uma string vazia, assim como um parâmetro seguido explicitamente por um sinal de igual sem conteúdo.

Segmentos vazios entre os sinais de e comercial são ignorados, pois não contêm parâmetros. Isso permite comparar a saída com o estado da aplicação: os valores ficam visíveis, os vazios não somem e os contadores mostram tanto as chaves distintas quanto o total de pares processados. O analisador não acessa o servidor de destino nem deduz tipos de negócio; valores como true, 42 e null continuam sendo strings.

Entenda a decodificação e o tratamento de chaves repetidas

Cada chave e cada valor são decodificados separadamente segundo as regras convencionais de formulários web. Um sinal de mais vira espaço, enquanto escapes percentuais como %20 e sequências UTF-8 com vários bytes tornam-se os caracteres pretendidos. O sinal de igual é especial somente em sua primeira ocorrência dentro de cada par; por isso, um valor pode conter outros sinais de igual sem ser dividido novamente.

Chaves repetidas são preservadas em vez de sobrescritas: a primeira ocorrência começa como string, a segunda transforma a propriedade em uma lista e as próximas são acrescentadas na ordem recebida. Por exemplo, tag=sale&tag=new produz uma lista tag com sale antes de new. Isso ajuda a analisar filtros, grupos de caixas de seleção e frameworks que serializam múltiplas escolhas sob um único nome.

Escapes percentuais inválidos geram um erro de entrada em vez de uma decodificação parcial, e bytes codificados que não formam UTF-8 válido também são recusados.

Use o resultado em testes, logs e diagnóstico de requisições

O objeto convertido funciona bem sempre que você precisa compreender uma consulta antes que o código aja sobre ela. Em testes automatizados, converta strings representativas em dados estáveis e confirme que filtros repetidos, texto internacional, sinais de mais e campos vazios chegam no formato previsto. Ao revisar logs, a estrutura é mais fácil de ler e comparar do que uma linha longa codificada, especialmente quando a mesma chave aparece várias vezes.

O conversor evita deliberadamente coerção de esquema: se a sua aplicação espera número, booleano, data ou uma convenção aninhada com colchetes, aplique depois a validação específica dela. Esse limite impede que uma ferramenta genérica invente significados que o remetente não declarou. Os nomes de propriedades são tratados com segurança como dados, inclusive quando lembram elementos internos do JavaScript.