Fetching contributors…
Cannot retrieve contributors at this time
75 lines (60 sloc) 2.17 KB


Easily send errors in Node.js HTTP servers.

Think like the ErrorDocument declarations in Apache config files.


var ErrorPage = require('error-page')

http.createServer(function (req, res) {
  // returns a function that we use to send error responses
  res.error = ErrorPage(req, res, { // options
    404: the404HandlerFunction,
    5xx: handleAll500s,
    403: 'forbidden.ejs', // template name integrates with Templar
    400: 'that was bad', // other strings just print out as-is
    "*": handleEverythingElse
    debug: false // show full stack traces, or just messages

  // .. some time later ..
  // .. we've decided that the page doesn't exist ..
  return res.error(404)

  // or maybe we decided that the request method is no good...
  // Give a little extra bit on the message.
  return res.error(405, "Allowed methods: GET, POST, HEAD")

  // or maybe they just need to try again in 10 seconds
  return res.error(503, {'retry-after':10})

  // or maybe we are a teapot
  return res.error(418)

  // or maybe something threw
  try {
  } catch (er) {
    return res.error(er)

Any arguments to the res.error function will be interpreted based on their type:

  • Number: the status code (defaults to 500, if it can't find one)
  • Error object: Some error that was thrown or raised somewhere (with a stack, etc.)
  • Other object: Bag o' headers which get set on the response.
  • Function: A handler to use, instead of the one set up initially
  • String: If there's a res.template from Templar, and it's a valid template name, then it'll use the template as the handler.
  • String that is not a template: A message (defaults to the message property on the Error object, if one was supplied, or the default message associated with the status code.)

The handler (or template) is called with the request and response objects, and a data object containing:

data = { message: message
       , code: code
       , statusCode: code
       , error: er
       , options: opts
       , request: req.method + ' ' + req.url
       , headers: req.headers
       , url: req.url