run-async
Advanced tools
Utility method to run function either synchronously or asynchronously using the common `this.async()` style.
Weekly downloads
Changelog
Remove is-promise
dependency in favor of inlining the implementation (done as a follow-up to a release of the is-promise
package breaking all sub-dependencies.)
run-async
is now dependency free.
Readme
Utility method to run a function either synchronously or asynchronously using a series of common patterns. This is useful for library author accepting sync or async functions as parameter. runAsync
will always run them as an async method, and normalize the multiple signature.
npm install --save run-async
Here's a simple example print the function results and three options a user can provide a function.
var runAsync = require('run-async');
var printAfter = function (func) {
var cb = function (err, returnValue) {
console.log(returnValue);
};
runAsync(func, cb)(/* arguments for func */);
};
this.async
printAfter(function () {
var done = this.async();
setTimeout(function () {
done(null, 'done running with callback');
}, 10);
});
printAfter(function () {
return new Promise(function (resolve, reject) {
resolve('done running with promises');
});
});
printAfter(function () {
return 'done running sync function';
});
runAsync.cb
supports all the function types that runAsync
does and additionally a traditional callback as the last argument signature:
var runAsync = require('run-async');
// IMPORTANT: The wrapped function must have a fixed number of parameters.
runAsync.cb(function(a, b, cb) {
cb(null, a + b);
}, function(err, result) {
console.log(result)
})(1, 2)
If your version of node support Promises natively (node >= 0.12), runAsync
will return a promise. Example: runAsync(func)(arg1, arg2).then(cb)
Copyright (c) 2014 Simon Boudrias (twitter: @vaxilart)
Licensed under the MIT license.
Utility method to run function either synchronously or asynchronously using the common `this.async()` style.
The npm package run-async receives a total of 15,438,879 weekly downloads. As such, run-async popularity was classified as popular.
We found that run-async demonstrated a not healthy version release cadence and project activity. It has 1 open source maintainer collaborating on the project.