Module: Roda::RodaPlugins::ErrorHandler

Defined in:
lib/roda/plugins/error_handler.rb

Overview

The error_handler plugin adds an error handler to the routing, so that if routing the request raises an error, a nice error message page can be returned to the user.

You can provide the error handler as a block to the plugin:

plugin :error_handler do |e|
  "Oh No!"
end

Or later via the error class method:

plugin :error_handler

error do |e|
  "Oh No!"
end

In both cases, the exception instance is passed into the block, and the block can return the request body via a string.

If an exception is raised, a new response will be used, with the default status set to 500, before executing the error handler. The error handler can change the response status if necessary, as well set headers and/or write to the body, just like a regular request.

Defined Under Namespace

Modules: ClassMethods, InstanceMethods

Class Method Summary collapse

Class Method Details

.configure(app, &block) ⇒ Object

If a block is given, automatically call the error method on the Roda class with it.



35
36
37
38
39
 
# File 'lib/roda/plugins/error_handler.rb', line 35

def self.configure(app, &block)
  if block
    app.error(&block)
  end
end