<cfabort>

Stops processing of a page at the tag location. CFML returns everything that was processed before the cfabort tag. The cfabort tag is often used with conditional logic to stop processing a page when a condition occurs.

This tag cannot have a body.

This tag is also supported within <cfscript>

<cfabort type=string showerror=string >
Attribute Description
type
string, optional

Define the abort type.

Allowed Values:

  • request (default): abort the entire request
  • page: abort the current page execution
showerror
string, optional

The error to display when cfabort executes. The error message displays in the standard CFML error page.

Examples

<cfset v = 3> 
<cfloop from="1" to="4" index="c"> 
    <cfif c is 2> 
        aborted
        <cfabort>
    <cfelse> 
        <cfset v = v + 1> 
    </cfif> 
    <cfoutput>c: #c#, v: #v#<br></cfoutput>
</cfloop> 
<hr>
<cfoutput>c: #c#, v: #v#</cfoutput>
<br>
not aborted

See also