@ostai/koa-response

Response middleware for koa that will handle response body and errors.

This module is designed to standardize server response structure.

Install

$ npm i @ostai/koa-response

Usage

const Koa = require('koa')
const Router = require('@koa/router')

const response = require('@ostai/koa-response')

const app = new Koa()
const router = new Router()

router.get('/foo', () => 'ok')

router.get('/bar', () => {
  const error = new Error('bar')
  error.status = 401
  throw error
})


app
.use(
  response({
    debug: true
  })
)
.use(router.routes())
.use(router.allowedMethods())


app.listen(8888)

> curl http://localhost:8888/foo

# http 200
# ok

> curl http://localhost:8888/bar

# http 401
# {"message":"bar"}

response(options?): Function

• options? Object
  • error? Function(ctx, error, rest): void the method to handle error
  • success? Function(ctx, body, rest): void the method to handle success
  • ...rest? Object
    • debug boolean=false Which is used by the default value of options.error. By default, if debug is false, error response will not contain message.

Returns Function the middleware function.

License

MIT