صفحات HTML

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

مكان وصفاتك هو صفحة حقيقية، والمتصفح لا يعرض إلا HTML. الصفحة عبارة عن سلسلة نصية من HTML: يرسل res.send الصفحة بصيغة text/html، وتملؤها سلسلة القالب بالبيانات.

app.get('/weather/:city', (req, res) => {
    const city = escapeHtml(req.params.city);
    res.send(`<h1>Weather in ${city}</h1><p>Sunny</p>`);
});

قد يحتوي النص القادم من مصدر خارجي، مثل جزء من عنوان URL أو عنوان كتبه شخص ما، على < أو &. إذا أدرجته في HTML كما هو، فسيصبح <script> شيفرةً تُنفَّذ في متصفح زائرك. تحوّل escapeHtml هذه المحارف إلى كيانات يعرضها المتصفح كنص. وهي تستبدل & أولًا، كي لا يُستبدل & في < مرة أخرى.

const escapeHtml = (text) =>
    text
        .replaceAll('&', '&amp;')
        .replaceAll('<', '&lt;')
        .replaceAll('>', '&gt;')
        .replaceAll('"', '&quot;');

التحدي

سهل

يعرض GET / صفحة HTML تسرد عناوين جميع الوصفات.
يرتبط كل عنوان بصفحته، مثل <a href="/recipes/2">.
يمر كل عنوان عبر escapeHtml.

افتح / في عرض الصفحة وانقر على Fish & Chips.

جرّب بنفسك

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) => {
    const { tag } = req.query;
    const list = tag ? recipes.filter((recipe) => recipe.tags.includes(tag)) : recipes;
    res.type('text').send(list.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('/api/recipes', (req, res) => {
    res.json(recipes);
});

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

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

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