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ą.
Wyzwanie
ŁatwyObecnie if (!title) przepuszcza tytuły takie jak 123 lub " ". Przed zapisaniem sprawdź typ i rozmiar każdego pola.
- W trasie POST w pliku
routes/tasks.jssprawdź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
errorzawierający słowotitle, na przykład:{ "error": "title must be a string of 1 to 100 characters" } - 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ćtruealbofalse. W przeciwnym razie zwróć status 400 i błąd zawierający słowodone:
Odrzucone żądanie PATCH niczego nie zmienia.{ "error": "done must be true or false" } - Jeśli przesłano
- 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;
Ta lekcja zawiera krótki quiz. Zacznij lekcję, żeby na niego odpowiedzieć i śledzić swoje postępy.
Wszystkie lekcje w sekcji API REST
1Zasoby i czasowniki
Zasoby i URL-eTworzenie za pomocą POST4Przeglądarki, wersje i konfiguracja
Czym jest originZezwalanie na dostęp z innego originCORSStrona wywołująca API2Walidacja i błędy
Walidacja danych wejściowychPoćwicz samodzielnie: Edytor online Express