com.teamdev.jxbrowser.js

Interface JsPromise

All Superinterfaces:

java.lang.AutoCloseable, Closeable, JsObject

public interface JsPromise
extends JsObject, Closeable

A JavaScript Promise.

Allows using Java code as promise handlers. The Promise object is alive while the web page where it was created is loaded. When the web page is unloaded, all the JavaScript objects are disposed. An attempt to access the already disposed JavaScript Promise will lead to the IllegalStateException.

Usage example:

   
     JsPromise jsPromise = frame.executeJavaScript("Promise.resolve('Resolved')");
     jsPromise.then(results -> System.out.println(results[0]));
   
 

Method Summary

Modifier and Type	Method and Description
JsPromise	catchError(JsPromiseHandler onRejected) Registers a rejection handler for this promise and returns a new one.
JsPromise	finallyExecute(JsPromiseHandler onFinally) Registers a handler that will be invoked if the promise is settled (fulfilled/rejected) and returns a new promise.
JsPromise	then(JsPromiseHandler onFulfilled) Registers a fulfillment handler for this promise and returns a new one.
JsPromise	then(JsPromiseHandler onFulfilled, JsPromiseHandler onRejected) Registers fulfillment and rejection handlers for this promise and returns a new one.

Methods inherited from interface com.teamdev.jxbrowser.js.JsObject

call, frame, hasProperty, ownPropertyNames, property, propertyNames, putProperty, removeProperty

Methods inherited from interface com.teamdev.jxbrowser.Closeable

close, isClosed

Method Detail

then

JsPromise then(JsPromiseHandler onFulfilled,
               JsPromiseHandler onRejected)

Registers fulfillment and rejection handlers for this promise and returns a new one.

The appropriate handler is called immediately if the promise is already settled.

Parameters:

onFulfilled - a handler that is invoked if the promise is fulfilled

onRejected - a handler that is invoked if the promise is rejected

Throws:

java.lang.IllegalStateException - if the JavaScript promise is already disposed

See Also:

JsPromiseHandler

then

JsPromise then(JsPromiseHandler onFulfilled)

Registers a fulfillment handler for this promise and returns a new one.

The handler is called immediately if the promise is already fulfilled.

Parameters:

onFulfilled - a handler that is invoked if the promise is fulfilled

Throws:

java.lang.IllegalStateException - if the JavaScript promise is already disposed

See Also:

JsPromiseHandler

catchError

JsPromise catchError(JsPromiseHandler onRejected)

Registers a rejection handler for this promise and returns a new one.

The handler is called immediately if the promise is already rejected.

Parameters:

onRejected - a handler that is invoked if the promise is rejected

Throws:

java.lang.IllegalStateException - if the JavaScript promise is already disposed

See Also:

JsPromiseHandler

finallyExecute

JsPromise finallyExecute(JsPromiseHandler onFinally)

Registers a handler that will be invoked if the promise is settled (fulfilled/rejected) and returns a new promise.

The handler is called immediately if the promise is already settled.

Parameters:

onFinally - a handler that is invoked if the promise is settled

Throws:

java.lang.IllegalStateException - if the JavaScript promise is already disposed

See Also:

JsPromiseHandler