Como pegar parâmetros GET da URL com JavaScript
Neste artigo você vai aprender a como pegar parâmetros GET da URL com JavaScript, utilizando um objeto muito interessante!

Fala programador(a), beleza? Neste artigo você vai aprender a como resgatar os parâmetros da URL com JS!
Estes parâmetros são também conhecidos como query string, que é caracterizado por tudo que fica após a ? na URL
Cada parâmetor é separado por um &, então podemos ter mais um também
O nosso exemplo será a URL:
https://www.meusite.com.br/produtos?categoria=livros&autor=Augusto
Aqui podemos dizer que há uma busca por produtos que sejam livros e com um dos autores sendo uma pessoa com nome de Augusto

Black Week do Nexus
A formação de IA mais completa do Brasil
- 7 formações · 112 cursos · 26 mil alunos
Podemos resgatar esta query string com JavaScript pelo seguinte código:
const urlParams = new URLSearchParams(window.location.search);
const products = urlParams.get("produtos") // livros
const author = urlParams.get("autor") // Augusto
Aqui temos três variáveis, a primeira inicializa o objeto com base na parte de pesquisa da URL, que é window.location.search
Depois obtemos cada um dos valores em variáveis distintas
E assim resgatamos os parâmetros que foram enviados por uma requisição GET!
Conclusão
No artigo de hoje você viu como pegar parâmetros GET da URL com JavaScript
Utilizamos a classe URLSearchParams para criar uma nova instância dele baseada na URL atual

VPS Hostinger para seu sistema
10% OFF extraVPS com SSD NVMe e backups semanais. O cupom MATHEUSHORADECODAR é aplicado automaticamente pelo link.
Ver planos com 10% OFF →Ela possui métodos que podem resgatar os valores da URL individualmente, com o get
Confira nossos cursos gratuitos no Youtube, com vídeos todos os dias! Se inscreva e ative o sininho para receber as notificações e aprender mais ainda sobre desenvolvimento web!
Veja também nosso catálogo de cursos na Udemy, todos com exercícios e projetos práticos, nas mais diversas tecnologias. O link acima contém um cupom de desconto para os cursos
E se você tentar pegar um parâmetro que não está na URL?
O get não quebra teu código, se liga
Ele simplesmente devolve null
const urlParams = new URLSearchParams(window.location.search)
const preco = urlParams.get("preco") // null, pois não existe na URL
Por isso é bom sempre checar antes de usar o valor
E pra isso existe o método has, que devolve true ou false dependendo se o parâmetro está lá ou não
if (urlParams.has("categoria")) { // faz algo só se categoria existir na URL }
Assim tu evita aquele erro chato de tentar usar um valor que veio vazio

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.Às vezes tu não sabe quais parâmetros vão vir na URL, e quer pegar todos de uma vez
Dá pra percorrer tudo com o forEach
const urlParams = new URLSearchParams(window.location.search)
urlParams.forEach((valor, chave) => { console.log(chave, valor) })
Repara que aqui a ordem é valor primeiro e chave depois, diferente do que muita gente espera
Já me confundi com isso, então fica o aviso!
Se tu quiser só a lista de chaves, tem o keys, e pros valores tem o values
E quando um mesmo parâmetro aparece repetido na URL (tipo ?cor=azul&cor=verde), o get traz só o primeiro
Pra pegar todos os valores desse parâmetro repetido tu usa o getAll, que devolve um array
Perguntas frequentes
Qual a diferença entre get e getAll?
O get devolve só o primeiro valor daquele parâmetro (uma string), e o getAll devolve um array com todos os valores, útil quando o mesmo parâmetro se repete na URL
O que o get retorna quando o parâmetro não existe?
Ele retorna null, por isso vale checar antes com o has
Preciso de alguma biblioteca externa pra isso?
Não, o URLSearchParams já vem embutido no navegador (built-in), tu não instala nada, é só usar
Dá pra usar isso no Node.js também?
Dá sim, o URLSearchParams também está disponível no Node, a diferença é que lá não existe o window.location, então tu passa a string da query direto pro objeto
Leia também
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 30min
Blog | Mais populares
As diferenças de var, let e const
Neste artigo veremos quais são as diferenças nestas três formas de declarar valores, e também casos de uso para var, let e const. Este conteúdo […]

Como redirecionar para outra página com JavaScript
Neste artigo vamos aprender como redirecionar para outra página com JavaScript, sem utilizar libs como jQuery, de uma maneira simples e efetiva. Fala programador(a), tudo […]
Exercícios de lógica de programação JavaScript com gabarito
Pratique lógica com JavaScript resolvendo um exercício antes de abrir o gabarito. Execute o código, teste uma entrada comum e um caso de borda, como […]

muito obrigado, isso resolveu meu problema de maneira muito simples.