Execute a function ambidextrously (normalizes the differences between synchronous and asynchronous functions). Useful for treating synchronous functions as asynchronous functions (like supporting both synchronous and asynchronous event definitions automatically).
- Use:
require('ambi')
- Install:
npm install --save ambi
// Import
var ambi = require('ambi');
var result;
// Sample methods
var syncMethod = function(x,y){
return x*y;
};
var asyncMethod = function(x,y,next){
return setTimeout(function(){
next(null,x*y);
},0);
};
// Call the synchronous function asynchronously
result = ambi(syncMethod, 5, 2, function(err,result){ // ambi adds support for this asynchronous callback automatically
console.log(err, result); // null, 10
});
console.log(result); // 10 - just like normal
// Call the asynchronous function asynchronously
result = ambi(asyncMethod, 5, 2, function(err,result){ // ambi doesn't do anything special here
console.log(err, result); // null, 10
});
console.log(result); // setTimeout - just like normal
- Ambi accepts the arguments
(method, args...)
method
is the function to executeargs...
is the arguments to send to the method- the last argument is expected to be the completion callback
- the completion callback is optional, but if defined, is expected to have the signature of
(err, results...)
- If the method has equal or more arguments than ambi received, then we assume it is an asynchronous method and let it handle calling of the completion callback itself
- If the method has less arguments than ambi received, then we assume it is a synchronous method and we'll call the completion callback ourselves
- If the synchronous method throws an error or returns an error, we'll try to call the completion callback with a single
err
argument - If the synchronous method executes without error, we'll try to call the completion callback with a
err
argument equal to null, and aresult
argument equal to the returned result of the synchronous method
- If the synchronous method throws an error or returns an error, we'll try to call the completion callback with a single
- Ambi can also introspect a different method than the one it fires, by passing
[methodToFire, methodToIntrospect]
as themethod
argument
Discover the change history by heading on over to the HISTORY.md
file.
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
These amazing people are maintaining this project:
- Benjamin Lupton [email protected] (https://github.com/balupton)
No sponsors yet! Will you be the first?
These amazing people have contributed code to this project:
Licensed under the incredibly permissive MIT license
Copyright © 2013+ Bevry Pty Ltd [email protected] (http://bevry.me)
Copyright © 2011-2012 Benjamin Lupton [email protected] (http://balupton.com)