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