com.brightech.mb.workflow.js.Extensions

Class Promise

java.lang.Object

com.brightech.mb.workflow.js.Extensions.Promise

public class Promise
extends java.lang.Object

Note: This simplified version does not cover all features of the JavaScript Promise API.
Always use try...catch for callbacks.

Constructor Summary

Constructors

Constructor and Description
Promise()

Method Summary

Modifier and Type	Method and Description
void	jsConstructor(java.lang.Object executor) Promise constructor - Creates a new Promise instance
void	jsFunction_all(java.lang.Object[] promises) Creates a Promise that resolves when all the provided Promises resolve, or rejects immediately when any of the provided Promises reject.
void	jsFunction_catch(java.lang.Object onRejected) Attaches a callback for only the rejection of the Promise.
void	jsFunction_race(java.lang.Object[] promises) Creates a Promise that settles (resolves or rejects) as soon as any of the provided Promises settle.
void	jsFunction_Reject(java.lang.Object reason) Creates a Promise that is rejected with the given reason.
void	jsFunction_Resolve(java.lang.Object value) Creates a Promise that is resolved with the given value.
void	jsFunction_then(java.lang.Object onFulfilled, java.lang.Object onRejected) Attaches callbacks for the resolution and/or rejection of the Promise.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Promise

public Promise()

Method Detail

jsConstructor

public void jsConstructor(java.lang.Object executor)

Promise constructor - Creates a new Promise instance

Parameters:

{function} - executor - A function that takes resolve and reject callbacks

jsFunction_then

public void jsFunction_then(java.lang.Object onFulfilled,
                            java.lang.Object onRejected)

Attaches callbacks for the resolution and/or rejection of the Promise. Returns a new Promise that will be resolved or rejected based on the outcome of the callback functions. This method enables Promise chaining.

Parameters:

{function|null} - [onFulfilled] - Callback to execute when the Promise is fulfilled. If not a function or null, it will be ignored and the fulfillment value will pass through unchanged.

{function|null} - [onRejected] - Callback to execute when the Promise is rejected. If not a function or null, it will be ignored and the rejection reason will pass through unchanged.

jsFunction_catch

public void jsFunction_catch(java.lang.Object onRejected)

Attaches a callback for only the rejection of the Promise. This is a convenience method equivalent to calling .then(null, onRejected). It enables cleaner error handling syntax in Promise chains.

Parameters:

{function} - onRejected - Callback to execute when the Promise is rejected. Receives the rejection reason as its argument.

jsFunction_Resolve

public void jsFunction_Resolve(java.lang.Object value)

Creates a Promise that is resolved with the given value. If the value is already a Promise, it returns that Promise unchanged. If the value is a thenable (has a 'then' method), it will be converted to a Promise. Otherwise, it creates a new Promise resolved with the given value.

Parameters:

{*} - value - The value to resolve the Promise with

jsFunction_Reject

public void jsFunction_Reject(java.lang.Object reason)

Creates a Promise that is rejected with the given reason. This is equivalent to creating a new Promise and immediately rejecting it.

Parameters:

{*} - reason - The reason for the rejection (typically an Error object)

jsFunction_all

public void jsFunction_all(java.lang.Object[] promises)

Creates a Promise that resolves when all the provided Promises resolve, or rejects immediately when any of the provided Promises reject. The resolved value is an array containing the resolved values of all input Promises in the same order as the input array.

Parameters:

{Array} - promises - An array of Promises or values to wait for

Throws:

{TypeError} - If the argument is not an array

jsFunction_race

public void jsFunction_race(java.lang.Object[] promises)

Creates a Promise that settles (resolves or rejects) as soon as any of the provided Promises settle. The returned Promise settles with the same value or reason as the first Promise that settles.

Parameters:

{Array} - promises - An array of Promises or values to race

Throws:

{TypeError} - If the argument is not an array