7.9. Trabalhando com rotas no ExpressJS: Trabalhando com query parameters nas rotas

Uma das principais características do ExpressJS, um framework para Node.js, é a facilidade com que permite a definição e manipulação de rotas. As rotas são essenciais em qualquer aplicação web, pois definem como as solicitações do cliente são tratadas pelo servidor. Neste capítulo, vamos focar em como trabalhar com parâmetros de consulta (query parameters) nas rotas do ExpressJS.

Para começar, o que são parâmetros de consulta? São valores que são passados na URL de uma solicitação HTTP e são comumente usados para filtrar resultados, paginar dados, ordenar dados, entre outras coisas. Eles são adicionados à URL após um ponto de interrogação (?) e são separados por um & se houver mais de um. Por exemplo, na URL http://meusite.com/produtos?categoria=livros&preco=asc, "categoria=livros" e "preco=asc" são parâmetros de consulta.

No ExpressJS, podemos acessar esses parâmetros de consulta através do objeto req.query. Por exemplo, se tivermos a rota /produtos e quisermos filtrar produtos por categoria e ordenar por preço, poderíamos fazer algo assim:

app.get('/produtos', function(req, res) {
  var categoria = req.query.categoria;
  var ordemPreco = req.query.preco;
  // Aqui você pode usar categoria e ordemPreco para filtrar e ordenar seus produtos
});

Como você pode ver, req.query é um objeto que contém todos os parâmetros de consulta como propriedades. Você pode acessar cada parâmetro de consulta individualmente, como fizemos acima, ou pode trabalhar com o objeto req.query como um todo, dependendo de suas necessidades.

Além disso, é importante notar que os valores dos parâmetros de consulta são sempre strings. Se você precisar deles como outro tipo de dado, terá que convertê-los. Por exemplo, se você tiver um parâmetro de consulta "pagina" que deve ser um número, você poderia fazer algo assim:

app.get('/produtos', function(req, res) {
  var pagina = parseInt(req.query.pagina, 10);
  // Agora você pode usar pagina como um número
});

Outra coisa a considerar ao trabalhar com parâmetros de consulta é que eles são opcionais. Se um cliente fizer uma solicitação para /produtos sem nenhum parâmetro de consulta, req.query será um objeto vazio. Portanto, você deve sempre verificar se um parâmetro de consulta existe antes de usá-lo:

app.get('/produtos', function(req, res) {
  if (req.query.categoria) {
    var categoria = req.query.categoria;
    // Filtre seus produtos por categoria
  }
  if (req.query.preco) {
    var ordemPreco = req.query.preco;
    // Ordene seus produtos por preço
  }
});

Em resumo, os parâmetros de consulta são uma ferramenta poderosa para tornar suas rotas mais flexíveis e interativas. Eles permitem que os clientes personalizem suas solicitações de maneira simples e intuitiva, e o ExpressJS torna muito fácil trabalhar com eles. No entanto, como qualquer ferramenta, eles devem ser usados com cuidado. Sempre verifique se os parâmetros de consulta existem antes de usá-los, e não se esqueça de que seus valores são sempre strings.

Espero que este capítulo tenha lhe dado uma boa visão geral de como trabalhar com parâmetros de consulta no ExpressJS. No próximo capítulo, vamos aprofundar ainda mais no roteamento ExpressJS, explorando como trabalhar com rotas dinâmicas.

Próxima página do Ebook Gratuito:

56Trabalhando com rotas no ExpressJS: Validando dados nas rotas

4 minutos