Skip to Content

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.ts

Vai 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 → handler

Export

  • 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áo access thì 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ưởng app/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.ts và *.telegram.ts không đi qua middleware.
  • access chỉ nhận giá trị viết thẳng: manh.run đọc nó, không chạy.
  • Không import manh/oauth. Deploy bỏ mọi app/middleware.ts import module đó.

Bước tiếp theo

Cập nhật