Skip to Content

*.job.ts

Mỗi file *.job.ts là một việc chạy nền. Code server đưa việc vào hàng đợi bằng enqueue, manh.run chạy nó sau và thử lại khi lỗi.

app/invoices/ ├── repository.ts ├── send.job.ts # enqueue("app/invoices/send.job.ts", …) └── [id:int]/ └── send/ └── post.ts # trả lời ngay, gửi hoá đơn trong job

Vai trò

Request phải trả lời nhanh. Việc chậm (gửi nhiều email, gọi AI, xử lý nhiều dòng, xuất file lớn) chuyển sang job: handler ghi phần chính, gọi enqueue với id, rồi trả response. File đặt ở thư mục nào cũng được, thường cạnh repository.ts của resource mà job xử lý.

Export

  • default: hàm async nhận payload mà enqueue truyền vào. Giá trị trả về không dùng.

Ví dụ

app/invoices/send.job.ts
import { email } from "manh/email"; import { getInvoice, markSent } from "./repository"; export default async function (payload: { invoiceId: number }) { const inv = await getInvoice(payload.invoiceId); if (inv.sentAt) return; // đã gửi ở lần chạy trước await email({ to: inv.customerEmail, subject: `Hoá đơn ${inv.code}`, html: renderInvoice(inv) }); await markSent(inv.id); }
app/invoices/[id:int]/send/post.ts
import { enqueue } from "manh/jobs"; export default async (c, { param }) => { enqueue("app/invoices/send.job.ts", { invoiceId: param.id }); return { queued: true }; };

Cần biết

  • Job dùng chung app/db và manh/* với handler, nhưng không có c và không có người dùng. Truyền id trong payload rồi đọc dữ liệu trong job.
  • Job lỗi được thử lại, tổng cộng tối đa 3 lần, cách nhau 30 rồi 60 giây. Job phải an toàn khi chạy hai lần.
  • Hẹn giờ chạy bằng delaySeconds, tối đa 30 ngày. Việc lặp theo lịch cố định thì dùng *.cron.ts.
  • Xem các lần chạy và lỗi ở mục Vận hành › Việc nền của không gian làm việc.

Bước tiếp theo

  • enqueue — tham số, hẹn giờ và giới hạn kích thước payload.
  • *.cron.ts — việc lặp theo lịch cố định thay vì theo request.
Cập nhật