Замена с помощью PUT
Часть раздела REST API путешествия по Node.js на Coddy. Урок 5 из 25.
Форма редактирования отправляет всю задачу целиком, все поля одновременно. PUT означает «заменить ресурс на этот», поэтому тело запроса должно быть полным.
PATCH /api/invoices/7 { "paid": true } → paid changes
PUT /api/invoices/7 { "amount": 90, "paid": true } → invoice 7 replaced
PUT /api/invoices/7 { "paid": true } → 400: amount missingPUT с пропущенным полем возвращает 400: замена половиной счёта привела бы к потере суммы. Поля, которыми управляет сервер, например id и время создания, берутся из старой версии, а не из тела запроса:
const { id, issuedAt } = invoices[index];
invoices[index] = { id, amount, paid, issuedAt };Задание
ЛегкоФорма редактирования отправляет всю задачу целиком. Добавь маршрут PUT, который заменяет задачу данными, отправленными клиентом.
- В
routes/tasks.jsдобавьPUT /api/tasks/:id. Тело запроса должно содержать оба поля, например{ "title": "Book the big room", "done": true }. - Замени
titleиdoneзадачи значениями из тела запроса. СохраниidиcreatedAtиз сохранённой задачи; никогда не бери их из тела запроса. Ответь со статусом 200 и всей задачей:{ "id": 2, "title": "Book the big room", "done": true, "createdAt": "2026-03-03T10:30:00.000Z" } - Если в теле запроса отсутствует
titleилиdone, ответь со статусом 400 и{ "error": "PUT needs every field: title and done" }и ничего не меняй. Поле считается отсутствующим, только если его вообще нет в теле запроса:"done": false— допустимое значение. - Если задачи с таким id нет, ответь со статусом 404 и
{ "error": "Task not found" }, как и в других маршрутах.
Попробуй: PUT /api/tasks/2 с { "title": "Book the big room", "done": true } возвращает 200 и задачу выше. Затем PUT /api/tasks/2 только с { "done": true } возвращает 400, а GET /api/tasks/2 по-прежнему показывает "Book the big room". PUT /api/tasks/99 с обоими полями возвращает 404.
Попробуйте сами
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.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;
В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.
Все уроки раздела REST API
1Ресурсы и глаголы
Ресурсы и URLСоздание с помощью POST4Браузеры, версии и конфигурация
Что такое originРазрешение другого originCORSСтраница, вызывающая APIПотренируйтесь самостоятельно: Песочница Express