Atualizações parciais com PATCH

Parte da seção APIs REST do Journey de Node.js da Coddy. Lição 3 de 18.

Marcar uma tarefa como concluída não deve significar enviar o título dela novamente. PATCH leva apenas os campos que mudam, e o servidor mantém todos os outros campos como estavam.

// PATCH /api/invoices/7   { "paid": true }
const { paid, amount } = req.body ?? {};
if (paid !== undefined) invoice.paid = paid;
if (amount !== undefined) invoice.amount = amount;
res.json(invoice);

Verifique cada campo em relação a undefined, não com if (paid): false é um valor que um cliente pode enviar. Copie os campos um por um em vez de espalhar req.body sobre o objeto, para que um cliente não possa alterar o id. Uma solicitação sem corpo deixa req.body como undefined, que é o caso coberto por ?? {}. A resposta é 200 com a fatura atualizada inteira.

Desafio

Fácil

PATCH /api/tasks/:id altera apenas os campos enviados no corpo, title ou done.
Ele responde com 200 e a tarefa completa.
Um id desconhecido responde com 404 e { "error": "Task not found" }.

Envie PATCH /api/tasks/2 com { "done": true }, depois GET /api/tasks/2 e, em seguida, o mesmo PATCH para /api/tasks/99.

Experimente você mesmo

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);
});

export default router;