Skip to content
This repository has been archived by the owner on Aug 17, 2023. It is now read-only.

Latest commit

 

History

History
113 lines (81 loc) · 2.23 KB

README.md

File metadata and controls

113 lines (81 loc) · 2.23 KB

toa-body

Request body parser for toa.

NPM version Build Status Downloads

Demo

const Toa = require('toa')
const toaBody = require('toa-body')

const app = new Toa()
toaBody(app)

app.use(function * () {
  this.body = yield this.parseBody()
})
app.listen(3000)
const Toa = require('toa')
const toaBody = require('toa-body')

const app = new Toa()
app.use(toaBody()) //  It will try to parse body for every request.

app.use(function () {
  this.body = this.request.body
})
app.listen(3000)

Installation

npm install toa-body

API

const toaBody = require('toa-body')

toaBody(app[, options])

It will add parseBody method to context.

  • options.encoding: requested encoding. Default is utf8.
  • options.formLimit: limit of the urlencoded body. If the body ends up being larger than this limit, a 413 error code is returned. Default is 56kb
  • options.jsonLimit: limit of the json body. Default is 1mb
  • options.extendTypes: support extend types:
toaBody(app, {
  extendTypes: {
    json: ['application/x-javascript'] // will parse application/x-javascript type body as a JSON string
  }
}))
  • options.parse: support custom parse:
const parseXml = require('xml2js').parseString

toaBody(app, {
  parse: function (buf) {
    var str = buf.toString('utf8')
    if (!this.is('text/xml')) return str
    // return promise or thunk function for async task
    return function (done) { parseXml(str, done) }
  }
}))

context.parseBody()

return thunk function.

this.body = yield this.parseBody()
this.parseBody()(function (err, body) {
  // this.request.body === body
  this.body = body
})

app.use(toaBody([options]))

Toa >= v2.x required.

Licences

(The MIT License)