Simple Cron-like scheduler for reoccurring tasks
Last updated 6 months ago by mr-yellow .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @momsfriendlydevco/scheduler 
SYNC missed versions from official npm registry.


Generic Cron-like scheduler for tasks that should execute periodically.

Scheduled times

The following scheduled times are supported:

  • * * * * * (i.e. six cron-timings) - Parsed by cron-parser
  • every * (reoccuring intervals) - Parsed by timestring
  • * (everything else) - Parsed by fix-time


This module uses the debug NPM module for debugging. To enable set the environment variable to DEBUG=scheduler or DEBUG=scheduler* for detail.

For example:

DEBUG=scheduler mocha



Global settings for the scheduler.

Available settings:

Setting Type Default Description
autoStart boolean true Automatically call Scheduler.start() when initialized
tickTimeout number 1000 (~1s) The precision of when to check the scheduled task queue
timeBias number 0 What offset (in milliseconds) to add to each timing
throwUnknown boolean true Complain about unknown time sequences within timings, single unknown timings will always throw


  • timeBias is intended to be used on a server with multiple instance profiles (i.e. each server could potentially execute similar processes). Setting it to a random number generator would ensure that not all tasks are executed within the same tick


Function called on each "tick". When called this function cancels the timing of the next tick. This function returns a promise which resolves when all queued tasks have completed.


Resume / execute the scheduler and begin checking for queued tasks on each Scheduler.settings.tickTimeout. Returns the chainable Scheduler instance.


Stops the scheduler, which will not check for future tick items. Returns the chainable Scheduler instance.

Scheduler.Task(timing, cb)

Task instance created within a scheduler. timing is an array of timings or a CSV of timings. cb is an optional callback function which gets attached.


Resets and reschedules the task based on the new timing. This overrides the timing provided in the constructor. Returns the chainable Task instance.


Sets the task to execute as if used in the constructor. Returns the chainable Task instance.

Current Tags

  • 0.0.10                                ...           latest (6 months ago)

5 Versions

  • 0.0.10                                ...           6 months ago
  • 0.0.8                                ...           7 months ago
  • 0.0.6                                ...           7 months ago
  • 0.0.4                                ...           7 months ago
  • 0.0.2                                ...           7 months ago
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (7)
Dev Dependencies (3)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |