es6pacts
Releasable, Reporting Promises for Javascript ES6
USAGE
This combines the releasable functionality of es6pledges with the reporting functionality of es6tasks.
Pacts can be used just like Promises, with the addition of
the ability to release the pact from it's obligation, via
resolve()
, reject()
or release()
and to get progress
reports via .progress()
Releasing a pledge results in the execution of a release function that can terminate the work, and settle the underlying Promise.
Progress reports stop when the pact is released, resolved, or rejected.
Example
function pactDelay( time, frequency = 100 ){
let timeout;
return new Pact(
// this is a delay function which reports progress every frequency milliseconds
( resolve, reject, report ) => {
let timeSlept = 0;
let f = () => {
let r = time > 0 ? timeSlept / time : 0;
report( timeSlept );
if ( timeSlept < ( time - frequency )){
timeSlept += frequency;
timeout = setTimeout( f, frequency );
}
else if (timeSlept < time ){
timeout = setTimeout( f, time - timeSlept );
timeSlept = time;
}
else{
resolve( time );
}
}
f();
},
// this is a release function
() => {
clearTimeout(timeout);
}
);
}
const pact = pactDelay( 10000, 100 )
.progress(( x ) => console.log( "progress: ", x ));
.then(( x ) => console.log( "result: ", x ));
setTimeout(() => { pact.resolve("faster"); }, 500);
Output:
progress: 0
progress: 100
progress: 200
progress: 300
progress: 400
result: faster
See Also
- @debonet/es6pledges
- @debonet/es6tasks