Throw

Throws a developer-specified exception, which can be caught with a catch block.

Method Signature

Throw(message=[any], type=[String], detail=[String], errorcode=[String], extendedinfo=[any], object=[Throwable])

Arguments

Argument
Type
Required
Description
Default

message

any

false

Message that describes exception event

type

String

false

The type of the exception

detail

String

false

Description of the event

errorcode

String

false

A custom error code that you supply

extendedinfo

any

false

Additional custom error data that you supply

object

Throwable

false

An instance of an exception object. If there is no message provided, this object will be thrown directly. If there is a message, a CustomException will be thrown and this object will be used as the cause.

Examples

Throw a custom exception

Use the throw function to throw a custom application exception.

<bx:script>
	throw( type="MyCustomError", message="A custom error has been thrown!" );
</bx:script>

Throw a custom http response exception

Use the throw function to throw a custom exception when the http response is invalid.

if( !isJSON( httpResponse.FILECONTENT ) ) {
	throw( type="InvalidHTTPResponse", message="The http response was not valid JSON" );
}

Additional Examples

// thrown as a statement example
try {
	throw "thrown";
} catch ( e) {
	dump( var=bxcatch, label="single argument keyword" );
}

try {
	throw message = "thrown";
	detail = "deets";
	errorCode = "403";
	type = "Test";
} catch ( e) {
	dump( var=bxcatch, label="additional arguments are ignored" );
}
// use this syntax instead
try {
	throw( message="thrown", detail="deets", errorCode="403", type="Test" );
} catch ( e) {
	dump( var=bxcatch, label="script throw with arguments" );
}

Last updated

Was this helpful?