async-settle
Settle an async function. It will always complete successfully with an object of the resulting state.
Handles completion and errors for callbacks, promises, observables and streams.
Will run call the function on nextTick
. This will cause all functions to be async.
Usage
Successful completion
var asyncSettle = require('async-settle');
asyncSettle(
function (done) {
done(null, 2);
},
function (error, result) {
}
);
Failed completion
var asyncSettle = require('async-settle');
asyncSettle(
function (done) {
done(new Error('Some Error Occurred'));
},
function (error, result) {
}
);
API
asyncSettle(fn, callback)
Takes a function to execute (fn
) and a function to call on completion (callback
).
fn([done])
Optionally takes a callback (done
) to call when async tasks are complete.
Executed in the context of async-done
, with all errors and results being settled.
Completion is handled by async-done
completion and error resolution.
callback(error, result)
Called on completion of fn
and recieves a settled object as the result
argument.
The error
argument will always be null
.
Settled Object
Settled values have two properties, state
and value
.
state
has two possible options 'error'
and 'success'
.
value
will be the value passed to original callback.
License
MIT