Menu
CoddyTech

状态码

本课属于 Coddy Node.js 学习旅程的“Express 基础”单元。第 7 课,共 23 课。

程序会先读取状态码,再读取响应正文,所以用 200 发送的错误看起来像是成功。

app.get('/api/loans', (req, res) => {
    if (!req.query.member) {
        res.status(400).json({ error: 'Say which member' });
        return;
    }
    res.json(loansOf(req.query.member));
});

res.status(code) 会设置状态并返回 res,因此可以在同一行接着调用 .json(...)。出错后,return 会停止函数运行。你最常遇到的状态码:

  • 200:请求成功(默认值)。
  • 201:已创建内容。
  • 400:请求有误,例如缺少字段。
  • 404:该路径或 ID 下没有内容。
  • 500:服务器发生故障。
challenge icon

挑战

简单

读取 API 的程序会先检查状态码,再检查响应正文。让未找到的情况在两者中都清楚显示。

  1. 在 server.js 的 /api/recipes/:id 路由中,更改找不到对应 id 的食谱时的处理方式。保留状态码 404,但发送以下 JSON,而不是文本:{"error": "No such recipe"}
  2. 不是数字的 id(例如 abc)也匹配不到食谱。它同样会得到 404 状态码和相同的 JSON。

试试看:按“运行”,然后发送 /api/recipes/99。你应该会看到状态码 404 和 {"error":"No such recipe"}。发送 /api/recipes/abc:同样会得到 404 状态码和 JSON。发送 /api/recipes/3:状态码为 200,并返回 Lentil Curry 食谱。

亲手试试

import express from 'express';
import { recipes } from './data.js';

const app = express();

app.get('/', (req, res) => {
    res.send('Welcome to Recipe Box');
});

// type('text') 会发送纯文本,因此每个标题都会单独占一行。
app.get('/recipes', (req, res) => {
    const { tag } = req.query;
    const list = tag ? recipes.filter((recipe) => recipe.tags.includes(tag)) : recipes;
    res.type('text').send(list.map((recipe) => recipe.title).join('\n'));
});

app.get('/recipes/:id', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).send('No such recipe');
        return;
    }
    res.send(recipe.title);
});

app.get('/api/recipes', (req, res) => {
    res.json(recipes);
});

app.get('/api/recipes/:id', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).send('No such recipe');
        return;
    }
    res.json(recipe);
});

app.get('/about', (req, res) => {
    res.send('Recipe Box collects family recipes.');
});

app.listen(3000, () => {
    console.log('Recipe Box is running on port 3000');
});

Express 基础中的所有课

自己练习: Express 在线编辑器