Construtor de query string de URL
Monte uma URL com parâmetros de consulta a partir de pares chave/valor, com codificação de formulário (espaço como +) ou RFC 3986 (%20). Importe parâmetros de uma URL existente.
https://example.com/search?q=coffee+%26+tea&page=2
Importar parâmetros de uma URL existente
O que é Construtor de query string?
O construtor transforma uma URL base e uma lista de pares chave/valor em uma URL corretamente codificada. Escolha a codificação de formulário HTML (espaços como +, como no URLSearchParams) ou a codificação percentual estrita do RFC 3986 (espaços como %20), e importe os parâmetros de uma URL existente para editá-los.
Como usar Construtor de query string
- Digite a URL base, por exemplo
https://example.com/search. - Preencha as linhas de chave e valor; use Adicionar parâmetro para mais linhas e × para remover uma.
- Escolha a codificação.
- Copie a URL resultante. Para editar um link existente, abra "Importar parâmetros de uma URL existente".
Exemplo
https://example.com/search, q = coffee & tea, page = 2
https://example.com/search?q=coffee+%26+tea&page=2
Com codificação RFC 3986: https://example.com/search?q=coffee%20%26%20tea&page=2
Quando usar Construtor de query string
Use para montar chamadas de API, links de rastreamento ou URLs de teste sem codificar à mão caracteres especiais como &, = ou espaços. Se você só quer ler os parâmetros de uma URL existente, o Analisador de URL é mais rápido.
Como funciona Construtor de query string
Linhas com chave vazia são ignoradas e os valores são codificados exatamente uma vez. A codificação de formulário usa URLSearchParams.toString(); o modo RFC 3986 usa encodeURIComponent e escapa também ! ' ( ) *. Qualquer query string já presente na URL base é substituída, e o #fragmento é mantido no final. A importação divide uma URL em ? e # e decodifica os pares com o URLSearchParams.
Casos de Uso Comuns
- Montar uma URL de busca cujo valor contém & ou =.
- Criar links de campanha com parâmetros UTM.
- Preparar requisições GET codificadas para testar APIs.
- Editar um parâmetro de uma URL longa sem quebrar o resto.
Perguntas Frequentes
Os espaços devem ser + ou %20?
A maioria dos servidores entende os dois em query strings. O + vem da codificação de formulários HTML; o %20 é a codificação genérica de URI e é mais seguro quando quem recebe não é um framework web típico.
Posso repetir uma chave?
Sim. Adicione várias linhas com a mesma chave, por exemplo tag=a e tag=b; elas são mantidas na ordem.
Caracteres não ASCII são aceitos?
Sim, eles são codificados como escapes percentuais em UTF-8; por exemplo, ế vira %E1%BA%BF.