Ở bài trước chúng ta đã tạo xong project MiniBlog với một route trang chủ tạm thời. Tiếp tục với series, bài này mình sẽ giới thiệu với mọi người về route trong Express 5: khai báo route theo HTTP method, tham số, cú pháp đường dẫn mới, app.route() và thứ tự khớp route.
1. Route là gì?
Route (định tuyến) là phần quyết định mỗi request gửi đến sẽ được xử lý bởi hàm nào (gọi là handler), dựa vào HTTP method và đường dẫn. VD: GET /posts trả về danh sách bài viết, còn GET /posts/route-trong-express-5 trả về một bài viết.
2. Khai báo route theo HTTP method.
Để khai báo route, các bạn sử dụng các phương thức của app trùng tên với HTTP method, với cú pháp như sau:
app.get(path, handler);
app.post(path, handler);
app.put(path, handler);
app.delete(path, handler);
Trong đó:
pathlà đường dẫn mà route xử lý. Query string (phần sau dấu?) không thuộc đường dẫn.handlerlà hàm nhận hai tham sốreq(request) vàres(response). Trong bài này mình chỉ dùngres.send()vàres.json()để trả kết quả, Bài 5 sẽ nói kỹ về request và response.
Các method khác cũng tương tự (app.patch(), app.options()...), còn app.all() nhận mọi method.
VD:
- methods.js
import express from 'express';
const app = express();
app.get('/posts', (req, res) => {
res.send('Danh sách bài viết');
});
app.post('/posts', (req, res) => {
res.send('Tạo bài viết mới');
});
app.put('/posts/hello-express', (req, res) => {
res.send('Cập nhật bài viết');
});
app.delete('/posts/hello-express', (req, res) => {
res.send('Xoá bài viết');
});
app.listen(3000);
Các bạn tạo các file ví dụ trong bài ngay trong thư mục miniblog (đã có Express và ESM, nhớ tắt npm run dev để trống cổng 3000). Chạy node methods.js rồi gọi thử bằng curl, option -X để chọn method:
curl http://localhost:3000/posts
# Danh sách bài viết
curl -X POST http://localhost:3000/posts
# Tạo bài viết mới
curl -X DELETE http://localhost:3000/posts/hello-express
# Xoá bài viết
curl -X PATCH http://localhost:3000/posts/hello-express
# ...
# <pre>Cannot PATCH /posts/hello-express</pre>
# ...
Cùng đường dẫn nhưng khác method là hai route khác nhau, method chưa khai báo sẽ nhận 404. Ngoài ra app.get() tự xử lý luôn method HEAD.
3. Tham số của route.
Đường dẫn như /posts/hello-express ở trên chỉ khớp đúng một bài viết. Để một route xử lý được mọi bài viết, chúng ta dùng tham số: một đoạn đường dẫn bắt đầu bằng dấu :. Giá trị tương ứng trên URL được đưa vào object req.params, với key là tên tham số.
VD:
- params.js
import express from 'express';
const app = express();
app.get('/posts/:slug', (req, res) => {
res.json(req.params);
});
app.get('/archive/:year-:month', (req, res) => {
res.json(req.params);
});
app.listen(3000);
// GET /posts/hello-express => {"slug":"hello-express"}
// GET /archive/2026-11 => {"year":"2026","month":"11"}
// GET /posts => 404
// GET /posts/a/b => 404
Một vài điểm các bạn cần nhớ:
- Mỗi tham số chỉ khớp một đoạn đường dẫn (không chứa
/), và không được bỏ trống. - Giá trị luôn là chuỗi (
"2026"chứ không phải số), muốn dùng như số thì các bạn tự chuyển kiểu. - Dấu
-và.được hiểu theo nghĩa đen, nên có thể đặt giữa hai tham số như:year-:month.
4. Cú pháp đường dẫn mới trong Express 5.
Ở bài 1 mình đã điểm qua ba thay đổi về cú pháp đường dẫn, phần này chúng ta đi vào chi tiết.
Wildcard và phần tùy chọn.
Wildcard *name khớp toàn bộ phần còn lại của đường dẫn, giá trị là mảng các đoạn. Dấu ngoặc nhọn {} đánh dấu phần tùy chọn, có thể bọc cả dấu / và tham số.
- paths.js
import express from 'express';
const app = express();
app.get('/tags{/:tag}', (req, res) => {
res.json(req.params);
});
app.get('/docs/*path', (req, res) => {
res.send(`Tài liệu: ${req.params.path.join('/')}`);
});
app.listen(3000);
// GET /tags => {}
// GET /tags/express => {"tag":"express"}
// GET /docs/express/routing.html => Tài liệu: express/routing.html
// GET /docs => 404
Khi không có phần tùy chọn, tag không xuất hiện trong req.params. Còn wildcard không khớp khi phía sau trống, muốn khớp cả /docs thì viết /docs{/*path}.
Không còn regex trong chuỗi.
Ở Express 4 chúng ta hay viết /posts/:id(\d+) để chỉ nhận id là số. Với Express 5, các ký tự ( ) [ ] ? + * ! được dành riêng, viết như vậy ứng dụng sẽ báo lỗi ngay khi khởi động:
PathError [TypeError]: Unexpected ( at index 10: /posts/:id(\d+); visit https://git.new/pathToRegexpError for info
Thay vào đó, các bạn truyền một mảng đường dẫn hoặc một đối tượng RegExp, các nhóm trong regex có trong req.params với key là số thứ tự:
- regex.js
import express from 'express';
const app = express();
// Một handler cho nhiều đường dẫn
app.get(['/news/:slug', '/blog/:slug'], (req, res) => {
res.json(req.params);
});
// Dùng đối tượng RegExp thay cho chuỗi
app.get(/^\/archive\/(\d{4})$/, (req, res) => {
res.json(req.params);
});
app.listen(3000);
// GET /news/abc => {"slug":"abc"}
// GET /blog/abc => {"slug":"abc"}
// GET /archive/2026 => {"0":"2026"}
// GET /archive/20 => 404
5. Gom route với app.route().
Khi nhiều method dùng chung một đường dẫn, các bạn dùng app.route(path) rồi nối các method vào, đường dẫn chỉ phải viết một lần nên tránh được gõ nhầm.
- route.js
import express from 'express';
const app = express();
app.route('/posts/:slug')
.get((req, res) => {
res.send(`Xem bài viết ${req.params.slug}`);
})
.put((req, res) => {
res.send(`Cập nhật bài viết ${req.params.slug}`);
})
.delete((req, res) => {
res.send(`Xoá bài viết ${req.params.slug}`);
});
app.listen(3000);
// GET /posts/hello-express => Xem bài viết hello-express
// PUT /posts/hello-express => Cập nhật bài viết hello-express
// DELETE /posts/hello-express => Xoá bài viết hello-express
6. Thứ tự khớp route.
Express kiểm tra các route theo thứ tự khai báo và dùng route đầu tiên khớp, nên route cụ thể phải đặt trước route có tham số.
VD: Mình muốn /posts/new là trang form viết bài, nhưng lại khai báo nó sau /posts/:slug.
- order.js
import express from 'express';
const app = express();
app.get('/posts/:slug', (req, res) => {
res.send(`Bài viết: ${req.params.slug}`);
});
app.get('/posts/new', (req, res) => {
res.send('Form viết bài mới');
});
app.listen(3000);
// GET /posts/new => Bài viết: new
Route /posts/:slug khớp trước với slug là "new", nên route phía sau không bao giờ được gọi. Đổi chỗ hai route thì /posts/new trả về Form viết bài mới, các slug khác vẫn vào /posts/:slug.
Lưu ý: Mặc định Express không phân biệt hoa thường và bỏ qua dấu / ở cuối, nên /Posts/abc hay /posts/abc/ cũng khớp /posts/:slug.
Chạy thử xong các bạn xoá các file ví dụ (methods.js, params.js, paths.js, regex.js, route.js, order.js), chúng không thuộc project MiniBlog.
7. Thêm route cho MiniBlog.
Giờ chúng ta thêm vào MiniBlog ba route: trang chủ, danh sách /posts và chi tiết /posts/:slug, dữ liệu tạm để trong một mảng.
// Dữ liệu tạm trong bộ nhớ, Bài 12 sẽ chuyển sang MySQL
const posts = [
{
id: 1,
title: 'Những tính năng mới trong Express 5',
slug: 'nhung-tinh-nang-moi-trong-express-5',
content: 'Giới thiệu Express 5...',
},
{
id: 2,
title: 'Route trong Express 5',
slug: 'route-trong-express-5',
content: 'Route trong Express...',
},
];
export default posts;
- app.js
import express from 'express';
import posts from './data/posts.js';
const app = express();
// Trang chủ
app.get('/', (req, res) => {
res.send('Chào mừng đến với MiniBlog!');
});
// Danh sách bài viết
app.get('/posts', (req, res) => {
res.json(posts);
});
// Chi tiết bài viết theo slug
app.get('/posts/:slug', (req, res) => {
const post = posts.find((item) => item.slug === req.params.slug);
if (!post) {
return res.status(404).send('Không tìm thấy bài viết');
}
res.json(post);
});
export default app;
File server.js giữ nguyên. Chạy npm run dev và kiểm tra:
curl http://localhost:3000/posts
# [{"id":1,"title":"Những tính năng mới trong Express 5",...},{"id":2,...}] (rút gọn)
curl http://localhost:3000/posts/route-trong-express-5
# {"id":2,"title":"Route trong Express 5","slug":"route-trong-express-5","content":"Route trong Express..."}
curl -i http://localhost:3000/posts/khong-ton-tai
# HTTP/1.1 404 Not Found
# ...
# Không tìm thấy bài viết
res.status(404) đặt status code cho response (Bài 5), còn trang 404 chung cho cả ứng dụng sẽ có ở Bài 7. Dữ liệu nằm trong bộ nhớ nên mỗi lần khởi động lại sẽ quay về như ban đầu.
Code đầy đủ của MiniBlog sau bài này nằm ở tag bai-03 trên GitHub; các thay đổi của riêng bài này: so sánh bai-02...bai-03.
8. Lời kết.
Như vậy là chúng ta đã tìm hiểu xong route trong Express 5: khai báo route theo method, lấy tham số qua req.params, cú pháp đường dẫn mới, app.route() và thứ tự khớp route. Bài sau mình sẽ giới thiệu với mọi người về router để tách các route trong app.js ra file riêng cho dễ quản lý.
Đăng ký nhận tin.
Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!





0 Comments