Enqueue functions, and call them in series.
npm install segue> Enqueue functions, and call them in series.
- Enqueue asynchronous functions to be called in series
- Pause or resume the calling of functions in the queue
- Optionally repeat the entire sequence of function calls indefinitely
- Small as it gets; 0.67 KB minified, or 0.41 KB minified and gzipped
- Error handling
There is a simple, runnable example you can play with:
``
$ git clone https://github.com/yuanqing/segue
$ cd segue
$ node example/index.js
There are also tests.
We first initialise our queue of functions by calling segue, passing in a doneCb callback:
`js
var segue = require('segue');
var doneCb = function(err) {
if (err) {
throw err;
}
};
var queue = segue(doneCb);
`
doneCb is called when all the functions in queue have run, or if an error had occurred in one of the functions.
Suppose that we have two functions, x and y…
`js
var x = function(cb, a) {
console.log(a); //=> 1
setTimeout(function() {
cb();
}, 100);
};
var y = function(cb, a, b) {
console.log(a, b); //=> 2, 3
cb();
};
`
…which we add into the queue via push():
`js`
queue.push(x, 1)
.push(y, 2, 3);
Then, call run() to kick off the sequence of function calls:
`js`
queue.run();
The function x will be called with the argument 1. After 100 milliseconds, x finishes execution, and function y is called with the arguments 2 and 3.
Note that every function added into the queue takes a cb callback as the first argument. Each function must call cb to signal that it has finished execution. As is convention, cb takes an err as its first argument. If err is truthy, the doneCb callback is called with said err, and no more functions in the queue are run.
We can pause the calling of functions in the queue on-the-fly by calling pause(). This method takes an optional callback that is called when the currently-running function has finished execution:
`js`
queue.pause(function() {
console.log(queue.isRunning()); //=> false
});
See that here, we’ve also used the isRunning() method.
To resume the calling of functions, call run():
`js`
queue.run();
console.log(queue.isRunning()); //=> true
Finally, note that we can also repeat the entire sequence of function calls indefinitely. Simply pass in opts with opts.repeat set to true when initialising the queue:
`js`
var queue = segue(doneCb, { repeat: true });
`js`
var segue = require('segue');
See Usage.
Initialises the function queue.
- The doneCb callback is called when all the functions in queue have run, or if an error had occurred in one of the function calls. The signature of doneCb is (err).opts.repeat
- Set to true to repeat the sequence of function calls indefinitely.
Adds a function fn into the queue, and returns the queue. The fn will be called with a cb callback, followed by the arguments specified here. In other words, the signature fn is (cb, [, arg1, arg2, ...]).
fn must call cb to signal that it has finished execution. If err is truthy, the doneCb callback is called with said err, and no more functions in the queue are run.
Starts (or resumes) the sequence of function calls, and returns the queue.
Pauses the sequence of function calls, and returns the queue. Calls the optional pauseCb callback when the queue is paused.
Returns true if a function in the queue is running, else returns false.
Install via npm:
`
$ npm i --save segue
Install via bower:
`
$ bower i --save yuanqing/segue
To use Segue in the browser, include the minified script in your HTML:
`html``