middleware.ts
middleware.ts chạy trước mọi handler trong thư mục của nó và các thư mục con, và có thể đặt access cho cả thư mục.
app/
├── middleware.ts # mọi handler
├── orders/
│ └── get.ts
└── (admin)/
├── middleware.ts # chỉ handler trong (admin)/
└── reports/get.tsVai trò
Middleware dùng cho việc chung của nhiều handler: ghi log, gắn mã request, kiểm một header. Đăng nhập và vai không cần middleware: app/auth.ts xác định người dùng, access chặn route.
Thứ tự chạy:
Request → xác định người dùng (app/auth.ts) → app/middleware.ts → app/(admin)/middleware.ts → kiểm access → handlerExport
default(tuỳ chọn): một middleware của Hono, hoặc một mảng chạy từ trái sang phải.access(tuỳ chọn): áp cho mọi handler bên dưới. Handler tự khai báoaccessthì giá trị của handler thắng.
File có thể chỉ có đúng một dòng export const access = ["admin"];.
Ví dụ
app/(admin)/middleware.ts
import type { MiddlewareHandler } from "hono";
export const access = ["admin"];
const logger: MiddlewareHandler = async (c, next) => {
const t = Date.now();
await next();
console.log(`${c.req.method} ${c.req.path} ${Date.now() - t}ms`, c.get("user")?.id ?? "-");
};
export default [logger];Cần biết
- Middleware chỉ áp xuống dưới: file trong
app/orders/không ảnh hưởngapp/users/. - Người dùng được xác định trước, nên middleware đọc được
c.get("user").accessđược kiểm sau mọi middleware. - Dừng request bằng
fail(...)từmanh/errors; người gọi nhận{ error, message, code }. - Job
*.cron.ts,*.email.tsvà*.telegram.tskhông đi qua middleware. accesschỉ nhận giá trị viết thẳng: manh.run đọc nó, không chạy.- Không import
manh/oauth. Deploy bỏ mọiapp/middleware.tsimport module đó.
Bước tiếp theo
- Đăng nhập và phân quyền — đặt
accesscho từng handler và cho cả thư mục. - get.ts, post.ts… — handler mà middleware chạy trước.
Cập nhật