Throws a developer-specified exception, which can be caught with a catch block.
throw([message] [, type] [, detail] [, errorcode] [, extendedinfo] [, object])
returns numeric
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| message | string | No | Message that describes exception event. | |
| type | string | No | Custom | * A custom type * Application Do not enter another predefined type; types are not generated by CFML applications. If you specify Application, you need not specify a type for cfcatch. |
| detail | string | No | Description of the event. CFML appends error position to description; server uses this parameter if an error is not caught by your code. |
|
| errorcode | string | No | A custom error code that you supply. | |
| extendedinfo | string | No | Additional custom error data that you supply. | |
| object | any | No | Requires the value of the cfobject tag name attribute. Throws a Java exception from a CFML tag. This attribute is mutually exclusive with all other attributes of this tag. |
Use the throw function to throw a custom application exception.
<cfscript>
throw(type="MyCustomError", message="A custom error has been thrown!");
</cfscript>
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");
}