Cron

Deno.cron() 是 Deno 的一个运行时 API，用于安排 JavaScript 或 TypeScript 代码按重复计划运行，计划使用 cron 语法 表示。它随 Deno 本身一起发布，因此在本地运行的相同代码无需修改即可部署。

Deno.cron 目前是一个不稳定的 API。要在本地使用 deno run，请启用 --unstable-cron 标志 （或将 "cron" 添加到 unstable 数组中， 位于 deno.json）。

deno run --unstable-cron main.ts

Deno.cron API 参考

定义一个 cron 任务 Jump to heading#

Deno.cron() 接受一个可读名称、一个计划， 以及一个处理函数。名称用于在日志中标识 cron 任务，计划 决定处理函数何时触发，所有时间均使用 UTC。

Deno.cron("log-a-message", "* * * * *", () => {
  console.log("This runs once a minute.");
});

计划可以是标准的 5 字段 cron 表达式，也可以是结构化对象：

Deno.cron("hourly-task", { hour: { every: 1 } }, () => {
  console.log("This runs once an hour.");
});

cron 任务必须在模块顶层注册，并且要在任何服务器启动之前完成。 嵌套在请求处理器、条件语句或回调中的定义不会被识别。

重试和退避 Jump to heading#

默认情况下，失败的处理函数调用不会重试。传入 backoffSchedule （一个毫秒延迟数组）即可在失败时重试：

Deno.cron(
  "retry-example",
  "* * * * *",
  { backoffSchedule: [1000, 5000, 10000] },
  () => {
    throw new Error("Will be retried up to three times.");
  },
);

在生产环境中运行 cron 任务 Jump to heading#

Deno.cron 在 Deno CLI 中将执行状态保存在内存中， 这意味着每个进程都会维护自己独立的一组 cron 任务。 对于生产工作负载，Deno Deploy 在此运行时 API 之上构建： 它会在部署时发现你的 Deno.cron() 定义，安排并调用它们，处理重试，并在仪表板中展示运行情况——这样你就 不需要自己维持一个长期运行的进程。