Skip to main content
Bijection allows you to schedule functions to run on a recurring basis. For example, cron jobs can be used to clean up data at a regular interval, send a reminder email at the same time every month, or schedule a backup every Saturday. Example: Cron Jobs

​
Defining your cron jobs

Cron jobs are defined in a crons.ts file in your bijection/ directory and look like:
The first argument is a unique identifier for the cron job. The second argument is the schedule at which the function should run, see Supported schedules below. The third argument is the name of the public function or internal function, either a mutation or an action.

​
Supported schedules

  • crons.interval() runs a function every specified number of seconds, minutes, or hours. The first run occurs when the cron job is first deployed to Bijection. Unlike traditional crons, this option allows you to have seconds-level granularity.
  • crons.cron() the traditional way of specifying cron jobs by a string with five fields separated by spaces (e.g. "* * * * *"). Times in cron syntax are in the UTC timezone. Crontab Guru is a helpful resource for understanding and creating schedules in this format.
  • crons.hourly(), crons.daily(), crons.weekly(), crons.monthly() provide an alternative syntax for common cron schedules with explicitly named arguments. The minuteUTC argument is optional. Leave it out and Bijection picks a minute for you, spreading runs across the hour.
Avoid scheduling on the exact top of the hourThe top of the hour (minute 0) is the busiest time on the clock. Apps receive the most inbound traffic, webhooks, and scheduled work right at :00. Scheduling recurring work away from the top of the hour keeps it away from your busiest moments and makes it less likely to compete for your app’s resources.The easiest way is to leave minuteUTC out and let Bijection pick a minute for you, spreading runs across the hour. You can also set a specific off-peak minute if you need a predictable time.
The @bijection/no-top-of-hour-crons ESLint rule flags schedules pinned to the top of the hour.

​
Viewing your cron jobs

You can view all your cron jobs in the Bijection console cron jobs view. You can view added, updated, and deleted cron jobs in the logs and history view. Results of previously executed runs of the cron jobs are also available in the logs view.

​
Error handling

Mutations and actions have the same guarantees that are described in Error handling for scheduled functions. At most one run of each cron job can be executing at any moment. If the function scheduled by the cron job takes too long to run, following runs of the cron job may be skipped to avoid execution from falling behind. Skipping a scheduled run of a cron job due to the previous run still executing logs a message visible in the logs view of the console.