状态码
本课属于 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:服务器发生故障。
挑战
简单读取 API 的程序会先检查状态码,再检查响应正文。让未找到的情况在两者中都清楚显示。
- 在
server.js的/api/recipes/:id路由中,更改找不到对应 id 的食谱时的处理方式。保留状态码 404,但发送以下 JSON,而不是文本:{"error": "No such recipe"} - 不是数字的 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 在线编辑器