Strings de consulta

Parte da seção Fundamentos de Express do Journey de Node.js da Coddy. Lição 5 de 23.

Uma página de lista geralmente precisa de opções, como quais receitas mostrar, e criar uma nova rota para cada opção seria demais.

app.get('/books', (req, res) => {
    const { author } = req.query;
    res.send(author ? 'Books by ' + author : 'All books');
});

A string de consulta é a parte da URL após ?, e o Express a coloca em req.query, um objeto. const { author } = req.query é uma forma abreviada de const author = req.query.author. GET /books?author=Austen resulta em req.query.author === 'Austen'. Sem ?, o valor é undefined. Várias opções são combinadas com &: /books?author=Austen&year=1813.

Um parâmetro de rota faz parte do caminho e nomeia uma coisa. Uma opção de consulta filtra ou ordena uma lista e pode ser omitida.

Desafio

Fácil

Os visitantes querem ver apenas receitas veganas ou apenas pratos para o jantar, sem uma página nova para cada tag.

Em server.js, altere a rota /recipes. Leia a opção tag da string de consulta. Cada receita em data.js tem uma lista de tags, como ['vegan', 'soup'].
Quando uma tag for fornecida, envie apenas os títulos das receitas cujas tags a incluam, um título por linha, como a rota faz agora.
Quando nenhuma tag for fornecida, envie todos os títulos, como antes.
Quando nenhuma receita tiver a tag, envie uma resposta vazia com o status 200.

Experimente: pressione Run e envie /recipes?tag=vegan. Você deverá ver duas linhas: Tomato Soup e Lentil Curry. Envie /recipes?tag=dinner: Lentil Curry e Fish & Chips. Envie /recipes?tag=dessert: uma resposta vazia, já que nenhuma receita tem essa tag. Envie /recipes: os quatro títulos.

Experimente você mesmo

import express from 'express';
import { recipes } from './data.js';

const app = express();

app.get('/', (req, res) => {
    res.send('Welcome to Recipe Box');
});

// type('text') envia texto simples, então cada título aparece em sua própria linha.
app.get('/recipes', (req, res) => {
    res.type('text').send(recipes.map((recipe) => recipe.title).join('\n'));
});

app.get('/recipes/:id', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).send('No such recipe');
        return;
    }
    res.send(recipe.title);
});

app.get('/about', (req, res) => {
    res.send('Recipe Box collects family recipes.');
});

app.listen(3000, () => {
    console.log('Recipe Box is running on port 3000');
});