競合

CoddyのNode.jsジャーニー「REST API」セクションの一部。レッスン 13/25。

「請求書を送信」という2つ目のタスクがリストを分かりにくくしていますが、その本文は有効です。これは409 Conflictです。リクエストがすでに保存されている内容と衝突しています。400は本文自体に誤りがあることを意味します。

const taken = users.some((u) => u.name.toLowerCase() === name.toLowerCase());
if (taken) {
    return sendError(res, 409, 'conflict', 'That username is taken');
}

人は「Ada」と「ada」を同じ名前として読むため、小文字に変換して比較します。リクエストで何かの名前を変更するときは、検索対象からその項目自体を除外します。そうしないと、名前を変更せずにフォームを保存したユーザーが、自分自身との衝突を起こしてしまいます。

チャレンジ

簡単

「Send the invoice」という名前のタスクが2つあると、リストが分かりにくくなります。別のタスクがすでに使っているタイトルは拒否しましょう。

routes/tasks.jsで、大文字と小文字を区別せずにタイトルを比較します。「Book the meeting room」と「book the MEETING room」は同じタイトルとして扱います。
POSTでは、スキーマのチェックに合格した後、すでにそのタイトルを持つタスクがあれば、sendErrorを使ってステータス409で応答し、何も追加しないようにします：
```
{ "error": { "code": "conflict", "message": "A task with this title already exists" } }
```
PATCH（本文にtitleが含まれる場合のみ）とPUTでも同じようにします。この2つのルートでは、検索時に変更対象のタスクを除外するため、そのタスクは自分自身のタイトルを維持したり、大文字と小文字だけを変更したりできます。拒否されたPATCHまたはPUTでは、何も変更されません。

試してみましょう： /api/tasksに{ "title": "book the meeting room" }をPOSTすると、タスク2のタイトルが「Book the meeting room」なので、コードconflictとともに409が返ります。{ "title": "Write the Project Brief" }を使ってPATCH /api/tasks/3を実行すると、409が返り、GET /api/tasks/3の結果には引き続き「Send the invoice」と表示されます。{ "title": "Book the meeting room", "done": true }を使ってPUT /api/tasks/2を実行すると、これはタスク2自身のタイトルなので、200が返ります。{ "title": "Order new chairs" }をPOSTすると、201が返ります。

自分で試してみよう

import { Router } from 'express';
import { z } from 'zod';
import { sendError, sendInvalid } from '../errors.js';
import { nextId, tasks } from '../store.js';

const router = Router();

// PUT が送信するタスク全体。.strict() は定義されていないフィールドを拒否します。
const Task = z
    .object({
        title: z.string().trim().min(1).max(100),
        done: z.boolean(),
    })
    .strict();
const NewTask = Task.partial({ done: true });
const TaskChanges = Task.partial();

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 sendError(res, 404, 'not_found', 'Task not found');
    }
    res.json(task);
});

router.post('/', (req, res) => {
    const result = NewTask.safeParse(req.body);
    if (!result.success) {
        return sendInvalid(res, result.error);
    }
    const { title, done = false } = result.data;
    const task = { id: nextId(), title, done, 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 sendError(res, 404, 'not_found', 'Task not found');
    }
    const result = TaskChanges.safeParse(req.body);
    if (!result.success) {
        return sendInvalid(res, result.error);
    }
    Object.assign(task, result.data);
    res.json(task);
});

router.put('/:id', (req, res) => {
    const index = tasks.findIndex((t) => t.id === Number(req.params.id));
    if (index === -1) {
        return sendError(res, 404, 'not_found', 'Task not found');
    }
    const result = Task.safeParse(req.body);
    if (!result.success) {
        return sendInvalid(res, result.error);
    }
    const { id, createdAt } = tasks[index];
    tasks[index] = { id, ...result.data, 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 sendError(res, 404, 'not_found', 'Task not found');
    }
    tasks.splice(index, 1);
    res.status(204).end();
});

export default router;