User Guide
cferror 123
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>
<!--- Example of cferror call within a page.
NOTE: If you use cferror type="VALIDATION" you MUST put it in
Application.cfc or Application.cfm --->
<cferror type = "REQUEST"
template = "request_err.cfm"
mailTo = "admin@mywebsite.com">
<!--- This query calls a non-existent datasource, triggering an error to be
handled. --->
<cfquery name="testQuery" datasource="doesNotExist">
select * from nothing
</cfquery>
<!--- Example of the page (request_err.cfm) to handle this error. --->
<html>
<head>
<title>We're sorry -- An Error Occurred</title>
</head>
<body>
<h2>We're sorry -- An Error Occurred</h2>
<p>
If you continue to have this problem, please contact #error.mailTo#
with the following information:</p>
<p>
<ul>
<li><b>Your Location:</b> #error.remoteAddress#
<li><b>Your Browser:</b> #error.browser#
<li><b>Date and Time the Error Occurred:</b> #error.dateTime#
<li><b>Page You Came From:</b> #error.HTTPReferer#
<li><b>Message Content</b>:
<p>#error.diagnostics#</p>
</ul>
Exception only error.message Error message associated with the exception.
error.rootCause The root cause of the exception. This structure
contains the information that is returned by a
cfcatch tag. For example, for a database exception,
the SQL statement that caused the error is in the
error.RootCause.Sql variable. For Java exceptions,
this variable contains the Java servlet exception
reported by the JVM as the cause of the "root
cause" of the exception.
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