express-custom-response

express-custom-response

Create custom response methods for express.js

Getting Started

Install the module with: npm install express-custom-response

##Quick Start

require('express-custom-response')();

Documentation

Module contain pre-defined custom responses:

res.serverError (extra)

• mixed extra
• Any data that have to be returned to user

return reponse with http code 500 and body:``` error: { error_message: 'We're sorry, a server error occurred. Please wait a bit and try again', error_code: 500, error_extra: null or extra }

**res.forbidden (fields, extra)**
- *object* **fields**
 - Object which contain validation error,  where key is field name and value is message
- *mixed* **extra**
 - Any data that have to be returned to user
 
> return reponse with http code 405 and body:```
error: {
    error_message: 'Validation failed',
	error_code: 405,
	fields: {email: 'Email has to be uniq'},
	error_extra: null or extra
}

res.notFound (name, extra)

• string name
• What server can't find
• mixed extra
• Any data that have to be returned to user

return reponse with http code 404 and body:``` error: { error_message: 'User not found', error_code: 404, error_extra: null or extra }

**res.ok (extra)**
- *mixed* **extra**
 - Any data that have to be returned to user
 
> return reponse with http code 404 and body:```
{} or extra

Create own response

If you want to add you own responses you should pass absolute path to module constructor

require('express-custom-response')(__dirname+ '/api/responses');

Then each script in this directory will be available as response method by filename. Example:

/** 
 * api/responses/accepted.js
 *
 * This will be available in controllers as res.accepted(message);
 */

module.exports = function(redirectTo, extra){
    //this is points to express.response
	this.status(202);
	this.send(message);
}

If you want to override exists pre-defined response simple add new script to your directory with name of response which you want to override