throw

Вызывает исключение, заданное разработчиком, которое можно перехватить блоком catch.

throw([message] [, type] [, detail] [, errorcode] [, extendedinfo] [, object]) → returns numeric

CF9+

Lucee

BL 1.0.0+

Справочник аргументов

message string

Сообщение с описанием события, вызвавшего исключение.

type string
По умолчанию: `Custom`

* Пользовательский тип * Application Не указывайте другой предопределённый тип; типы не создаются приложениями CFML. Если указать Application, тип для cfcatch указывать не нужно.

Значения:

Custom
Application
Database
Template
Security
Object
MissingInclude
Expression
Lock
SearchEngine

detail string

Описание события. CFML добавляет к описанию позицию ошибки; сервер использует этот параметр, если ошибка не перехвачена вашим кодом.

errorcode string

Пользовательский код ошибки, который вы указываете.

extendedinfo string

Дополнительные пользовательские данные об ошибке, которые вы указываете.

object any

Требуется значение атрибута name тега cfobject. Вызывает исключение Java из тега CFML. Этот атрибут нельзя использовать одновременно с другими атрибутами данного тега.

Примеры
Пример кода, вызывающего функцию throw

Вызов пользовательского исключения

Используйте функцию throw, чтобы вызвать пользовательское исключение приложения.

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

Вызов пользовательского исключения HTTP-ответа

Используйте функцию throw, чтобы вызвать пользовательское исключение, если HTTP-ответ некорректен.

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

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/throw