Blog

Brad Wood

August 09, 2012

Spread the word


Share your thoughts

 

ColdBox gives you several ways to deal with unhandled exceptions in your application such as the exceptionHandler event and the onException interception point to name a couple.  With either of those approaches, you can redirect the request to a different event.  If you don't redirect or abort the request though, ColdBox will eventually display the contents of your error template.  
 
By default the error template is /coldbox/system/includes/BugReport.cfm.  This file has the familiar "Oops! Exception Encountered" header.  While BugReport.cfm is chock-full of juicy error details (including the SQL of queries that errored), it isn't the kind of information you want to be revealing to the general public.  
 
This is where your customErrorTemplate setting from the ColdBox config file comes in.  Set this to the path of the page you want your users to see when something goes wrong on the site.  
 
settings.customErrorTemplate = "/includes/sorry.cfm";
 
You'll probably want to display a comforting message, a link to your webmaster's E-mail address, or your customer service number.  If you're feeling cheeky, you could try an octocat, or fail whale.  :)  Remember, your custom error template is NOT a view.  It won't be rendered inside your site layout and it won't have access to variables a view normally gets, but it will have an exceptionBean object passed in.  You can go digging for what you need with getController(), but 1be careful-- you don't know what kind of state the framework is in.  If you create an error on this page, it will bubble up to the onError method in your application.cfc.
 
 
P.S. This is an excellent place to use environment overrides to use the default error page on your dev and staging server, but the pretty one on production.  Just set the path to the pretty page in your main settings block, and override it with an empty string (which means use the default) in your lower environment overrides.

Add Your Comment

(1)

Oct 10, 2013 17:22:57 UTC

by Tim Brown

What if i just want to return the execption information as JSON so it can be gracefully displayed via my client side code? It doesn't appear I can stop execution within the onException() handler using renderData().noExecution() as renderData is ignored (as stated in the docs). Do I just need to set some headers and return the JSON manually via cfcontent? Thanks!

Recent Entries

Into the Box 2024 Last Early Bird Days!

Into the Box 2024 Last Early Bird Days!

Time is ticking, with less than 60 days remaining until the excitement of Into the Box 2024 unfolds! Don't let this golden opportunity slip away; our exclusive Early Bird Pricing is here for a limited time only, available until March 31st. Why wait? Secure your seat now and take advantage of this steal!

Maria Jose Herrera
Maria Jose Herrera
March 20, 2024
Ortus February Newsletter 2024

Ortus February Newsletter 2024

Welcome to Ortus Solutions’ monthly roundup, where we're thrilled to showcase cutting-edge advancements, product updates, and exciting events! Join us as we delve into the latest innovations shaping the future of technology.

Maria Jose Herrera
Maria Jose Herrera
March 06, 2024
Unveiling the Future of CFML Development - 3rd Round of Sessions

Unveiling the Future of CFML Development - 3rd Round of Sessions

Welcome back to our journey into the future of CFML development! As excitement continues to build for Into the Box 2024, we're thrilled to bring you the latest updates on what promises to be a transformative event. Continuing our blog post series, let's delve deeper into the third wave of session releases and discover the key surprises awaiting attendees. Learn More

Maria Jose Herrera
Maria Jose Herrera
March 01, 2024