Package io.karatelabs.js

Class EngineException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.karatelabs.js.EngineException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

EngineInterruptedException

public class EngineException
extends RuntimeException

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
EngineException(String message, Throwable cause)
EngineException(String message, Throwable cause, String jsErrorName)
EngineException(String message, Throwable cause, String jsErrorName, String jsMessage)

Method Summary

Modifier and Type	Method	Description
String	getJsErrorName()
String	getJsMessage()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

EngineException

public EngineException(String message,
 Throwable cause)

EngineException

public EngineException(String message,
 Throwable cause,
 String jsErrorName)

Parameters:

jsErrorName - canonical JS error constructor name ("TypeError" | "ReferenceError" | "RangeError" | "SyntaxError" | "URIError" | "EvalError" | "Error" | null if non-JS origin)

EngineException

public EngineException(String message,
 Throwable cause,
 String jsErrorName,
 String jsMessage)

Parameters:

jsErrorName - canonical JS error constructor name (see above)

jsMessage - the raw JS-side .message value — what e.message inside a JS catch would observe. Distinct from Throwable.getMessage(), which carries the host-facing "js failed: / Code: / Error: ..." frame for logs. Pass null when no JS-origin message is available.

Method Details

getJsErrorName

public String getJsErrorName()

Returns:

the JS error constructor name when this exception originated from an uncaught JS throw; null for Java-origin errors (the caller can still inspect Throwable.getMessage() or the cause chain).

getJsMessage

public String getJsMessage()

Returns:

the unframed JS-side message (what e.message would be inside a JS catch), or null when the exception has no JS-origin message. Callers building a JS-facing surface should prefer this over Throwable.getMessage(), which intentionally carries host-side framing (file/line/column) for logging.