Package Exports

@momsfriendlydevco/scheduler

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@momsfriendlydevco/scheduler) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@MomsFriendlyDevCo/Scheduler

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

Debugging

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

API

Scheduler.settings

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

Notes:

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

Scheduler.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.

Scheduler.start()

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

Scheduler.pause()

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.

Scheduler.Task.timing(newTiming)

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

Scheduler.Task.task(cb)

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