سلاسل الاستعلام

جزء من قسم أساسيات Express في رحلة Node.js على Coddy. الدرس 5 من 20.

غالبًا ما تحتاج صفحة القائمة إلى خيارات، مثل تحديد الوصفات التي تريد عرضها، وسيكون إنشاء مسار جديد لكل خيار أمرًا مبالغًا فيه.

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

سلسلة الاستعلام هي الجزء من عنوان URL الذي يأتي بعد ?، ويضعها Express في req.query. يؤدي GET /books?author=Austen إلى req.query.author === 'Austen'. إذا لم توجد ?، تكون القيمة undefined. تُربط الخيارات المتعددة باستخدام &: /books?author=Austen&year=1813.

مُعامِل المسار جزء من المسار، ويُسمّي عنصرًا واحدًا. أما خيار الاستعلام فيُصفّي القائمة أو يرتّبها، ويمكن الاستغناء عنه.

التحدي

سهل

يعرض GET /recipes?tag=vegan عناوين الوصفات التي تحمل هذا الوسم فقط، كل عنوان في سطر.
من دون tag، يعرض جميع العناوين.

أرسل GET /recipes?tag=vegan وGET /recipes?tag=dessert وGET /recipes.

جرّب بنفسك

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

const app = express();

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

// ترسل type('text') نصًا عاديًا، لذا يظهر كل عنوان في سطر منفصل.
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');
});