User Guide
104 Chapter 2: ColdFusion Tags
In exception error handling pages, you can access the error variables that are also available to the
cfcatch tag. See cfcatch for a description of these variables. To use these variables, prefix them
with "cferror."
Note: If type = "exception" you can substitute the prefix cferror for Error; for example,
cferror.diagnostics, cferror.mailTo, or cferror.dateTime.
Example
<h3>cferror Example</h3>
<p>cferror lets you display custom HTML pages when errors occur. This lets you
maintain a consistent look and feel within the application even when
errors occur. No CFML can be displayed in the pages, except specialized
error variables.
<p>cftry/cfcatch is a more interactive way to handle CF errors within a CF page
than cferror, but cferror is a good safeguard against general errors.
<p>You can also use cferror within Application.cfm to specify error
handling responsibilities for an entire application.
<!--- Example of cferror call within a page --->
<cferror type = "REQUEST"
template = "request_err.cfm"
mailTo = "admin@mywebsite.com">
<!--- Example of the page to handle this error --->
<html>
<head>
<title>We’re sorry -- An Error Occurred</title>
</head>
<body>
Request and
Exception
error.diagnostics Detailed error diagnostics from ColdFusion MX.
error.mailTo E-mail address (same as value in
cferror.MailTo).
error.dateTime Date and time when error occurred.
error.browser Browser that was running when error occurred.
error.remoteAddress IP address of remote client.
error.HTTPReferer Page from which client accessed link to page where
error occurred.
error.template Page executing when error occurred.
error.generatedContent The content generated by the page up to the point
where the error occurred.
error.queryString URL query string of client's request.
Exception only error.messge Error message associated with the exception.
error.rootCause Java servlet exception reported by the JVM as the
cause of the "root cause" of the exception. This
variable is a Java object.
error.tagContext Array of structures containing information for each
tag in the tag stack. The tag stack consists of each
tag that is currently open.
error.type Exception type.
Page type Error variable Description