Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é query string?

    A query string é a parte da URL que pode carregar filtros e outros parâmetros após o sinal de interrogação. A aplicação define como interpretar os valores.

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    A consulta é um componente da URL

    A query string é a parte de consulta de uma URL, usada com frequência para transportar filtros, termos de busca ou parâmetros de paginação. Ela aparece depois do sinal ? e termina no início do fragmento, marcado por #, quando ele existe. O caminho e a consulta são componentes distintos do endereço.

    Na URL https://example.com/produtos?pagina=2&ordem=preco, o caminho é /produtos. A consulta contém os pares pagina=2 e ordem=preco, separados por &. A aplicação pode interpretá-los como segunda página ordenada por preço, mas esses nomes não têm uma função universal definida pelo padrão de URLs.

    Como preservar os valores dos parâmetros

    A interface URLSearchParams manipula pares de nome e valor usando a codificação de formulários. Isso permite incluir um caractere como & no valor sem confundi-lo com o separador entre parâmetros. O padrão WHATWG define essa interpretação.

    O exemplo abaixo monta uma consulta com JavaScript, sem fazer uma requisição de rede:

    const url = new URL('https://example.com/busca')
    url.searchParams.set('q', 'café & pão')
    console.log(url.search)
    console.log(url.searchParams.get('q'))

    A primeira saída é ?q=caf%C3%A9+%26+p%C3%A3o. Os espaços foram representados por + e o caractere & do valor foi codificado como %26. A segunda saída recupera café & pão, confirmando que a expressão permaneceu dentro de um único parâmetro.

    Você precisa comparar o valor interpretado ao investigar diferenças na URL. A propriedade search inclui o sinal de interrogação e pode usar uma representação diferente daquela produzida por searchParams. Uma alteração nos parâmetros pode reescrever a consulta, inclusive substituir %20 por + para representar espaços, como explica a documentação de URL.search.

    Dúvidas frequentes

    Perguntas frequentes sobre query string

    A query string pertence ao caminho da URL?
    O caminho e a consulta são componentes separados. Em /produtos?pagina=2, o caminho é /produtos e a consulta contém pagina=2.
    Toda query string precisa usar nome=valor?
    A consulta é um componente da URL e não exige esse formato em todos os usos. Pares de nome e valor separados por & são a convenção interpretada por URLSearchParams.
    Por que um espaço pode aparecer como + ou %20?
    A interface URLSearchParams usa a codificação de formulários e representa espaços com +. A propriedade search de URL pode representar o mesmo espaço como %20, por isso o texto serializado pode mudar sem alterar o valor interpretado.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao desenvolver filtros e buscas, você precisa montar os parâmetros da URL e conferir os valores que a aplicação recebe.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano