Menu
CoddyTech

Walidacja danych wejściowych

Część sekcji API REST ścieżki Node.js w Coddy. Lekcja 6 z 25.

Klient może wysłać w treści żądania cokolwiek, a if (!name) blokuje tylko puste wartości. 123, true i ["x"] są wartościami prawdziwymi i przechodzą. Przechodzi też ciąg składający się ze spacji: wykryj go za pomocą trim(), ponieważ ' '.trim() to ''. Sprawdź typ każdego pola za pomocą typeof, a następnie jego ograniczenia:

const { seats } = req.body ?? {};
if (typeof seats !== 'number' || !Number.isInteger(seats) || seats < 1) {
    return res.status(400).json({ error: 'seats must be a whole number from 1' });
}

Napisz komunikat z myślą o osobie, która będzie czytać odpowiedź: podaj nazwę pola i określ, jakie musi być, aby wiedziała, co poprawić. Żądanie PATCH sprawdza tylko pola, które zostały w nim przesłane, ponieważ pozostałe się nie zmieniają.

challenge icon

Wyzwanie

Łatwy

Obecnie if (!title) przepuszcza tytuły takie jak 123 lub " ". Przed zapisaniem sprawdź typ i rozmiar każdego pola.

  1. W trasie POST w pliku routes/tasks.js sprawdź title:
    • Musi być ciągiem znaków.
    • Nie może być pusty ani zawierać wyłącznie spacji.
    • Może mieć najwyżej 100 znaków, łącznie ze spacjami.

    Jeśli którykolwiek z tych warunków nie jest spełniony, zwróć status 400 i komunikat error zawierający słowo title, na przykład:

    { "error": "title must be a string of 1 to 100 characters" }
  2. W trasie PATCH sprawdzaj tylko pola przesłane w treści żądania:
    • Jeśli przesłano title, obowiązuje ta sama reguła i ten sam rodzaj błędu.
    • Jeśli przesłano done, jego wartością musi być true albo false. W przeciwnym razie zwróć status 400 i błąd zawierający słowo done:
    { "error": "done must be true or false" }
    Odrzucone żądanie PATCH niczego nie zmienia.
  3. Prawidłowe treści żądań nadal działają: POST nadal zwraca 201, a PATCH z { "done": true } nadal zwraca 200. Pozostaw PUT bez zmian; schematy sprawdza też zod.

Wypróbuj: wyślij POST z { "title": 123 } do /api/tasks: otrzymasz 400 z błędem dotyczącym title. Wyślij POST z { "title": " " }: również otrzymasz 400. PATCH /api/tasks/2 z { "done": "yes" }: otrzymasz 400 z błędem dotyczącym done, a GET /api/tasks/2 nadal pokaże "done": false. PATCH /api/tasks/2 z { "done": true }: otrzymasz 200.

Spróbuj swoich sił

import { Router } from 'express';
import { nextId, tasks } from '../store.js';

const router = Router();

router.get('/', (req, res) => {
    res.json(tasks);
});

router.get('/:id', (req, res) => {
    const task = tasks.find((t) => t.id === Number(req.params.id));
    if (!task) {
        return res.status(404).json({ error: 'Task not found' });
    }
    res.json(task);
});

router.post('/', (req, res) => {
    const { title } = req.body ?? {};
    if (!title) {
        return res.status(400).json({ error: 'title is required' });
    }
    const task = { id: nextId(), title, done: false, createdAt: new Date().toISOString() };
    tasks.push(task);
    res.status(201).location(`/api/tasks/${task.id}`).json(task);
});

router.patch('/:id', (req, res) => {
    const task = tasks.find((t) => t.id === Number(req.params.id));
    if (!task) {
        return res.status(404).json({ error: 'Task not found' });
    }
    const { title, done } = req.body ?? {};
    if (title !== undefined) task.title = title;
    if (done !== undefined) task.done = done;
    res.json(task);
});

router.put('/:id', (req, res) => {
    const index = tasks.findIndex((t) => t.id === Number(req.params.id));
    if (index === -1) {
        return res.status(404).json({ error: 'Task not found' });
    }
    const { title, done } = req.body ?? {};
    if (title === undefined || done === undefined) {
        return res.status(400).json({ error: 'PUT needs every field: title and done' });
    }
    const { id, createdAt } = tasks[index];
    tasks[index] = { id, title, done, createdAt };
    res.json(tasks[index]);
});

router.delete('/:id', (req, res) => {
    const index = tasks.findIndex((t) => t.id === Number(req.params.id));
    if (index === -1) {
        return res.status(404).json({ error: 'Task not found' });
    }
    tasks.splice(index, 1);
    res.status(204).end();
});

export default router;
quiz iconSprawdź się

Ta lekcja zawiera krótki quiz. Zacznij lekcję, żeby na niego odpowiedzieć i śledzić swoje postępy.

Wszystkie lekcje w sekcji API REST

Poćwicz samodzielnie: Edytor online Express