Run a Job on a Schedule#

A job is a script plus a cron expression. This example is the script half: it logs the moment it runs, so you can confirm a schedule is firing. Pair it with a schedule and watch the runs arrive.

The Script#

// scheduled-heartbeat.js
const now = new Date();
console.log(`Heartbeat at ${now.toISOString()}`);

How It Works#

• Each scheduled run executes the file again from the top, so the timestamp reflects the current run.
• Schedules are evaluated on the server. The job fires on time whether or not the site is open.

Setup#

Name the file scheduled-heartbeat.js, then create a job that points at it. Some useful schedules:

Run it once with Run now before saving the schedule to confirm the script is correct.

Related#

• Writing Jobs
• Running and Debugging