koa-parser/README.md
The Gitter Badger a6a21970ed Add Gitter badge
2017-10-27 12:55:09 +00:00

52 lines
1.2 KiB
Markdown

# Koa Body Parser
[![Join the chat at https://gitter.im/cupcakearmy/koa-parser](https://badges.gitter.im/cupcakearmy/koa-parser.svg)](https://gitter.im/cupcakearmy/koa-parser?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![npm](https://img.shields.io/npm/v/cca-koa-parser.svg)](https://www.npmjs.com/package/cca-koa-parser)
[![npm](https://img.shields.io/npm/dt/cca-koa-parser.svg)]()
[![npm](https://img.shields.io/npm/l/cca-koa-parser.svg)]()
Koa-Middleware for parsing body parameters in the request. Lightweight and no dependencies.
### Install
```bash
npm install cca-koa-parser --save
```
##### Supported encodings:
- form-data
- x-www-form-urlencoded
- json
### Complete Example
```javascript
const
Koa = require('koa'),
parser = require('cca-koa-parser'),
router = require('cca-koa-router')
const
app = new Koa(),
port = 3000
app.use(parser)
app.use(router(_ => {
_.post('/', (c, n) => {
c.body = c.request.body
})
}))
app.listen(port)
```
## Documentation
##### ~ `body` Element
The Parser defines an object `ctx.request.body` where all the sent parameters are stored
###### Example
```javascript
// Request: HTTP POST /
ctx.request.body['username'] => "joe"
```