A bit of Docs

This commit is contained in:
nicco 2017-08-18 18:20:10 +02:00
parent bdcf84f686
commit 039b7fb6d0

View File

@ -1,2 +1,68 @@
# koa-cookie
Koa Cookie Utility
### Complete Example
```javascript
const
Koa = require('koa'),
router = require('koa-simple-router'),
cookie = require('cca-koa-cookie')
const
app = new Koa(),
port = 3000
// Parse Parameters
app.use(require(cookie))
app.use(router({}, _ => {
_.get('/set', (c, n) => {
// Set a cookie
c.request.cookie.set({
key: 'my_id',
value: '12345678',
path: '/',
maxAge: 100,
httpOnly: true,
secure: false
})
c.body = [200, 'Cookie Set']
})
_.get('/get', (c, n) => {
c.body = [200, c.request.cookies]
})
}))
app.listen(port)
```
## Documentation
##### ~ `cookies` Array
The Cookie Parser sets an array `ctx.request.cookies` with the cookies that where sent with the request.
###### Example
Let's say we get a cookie (`Foo=Bar;`) We can access it in the context of Koa like this: `ctx.request.cookies['Foo']` => `"bar"`
##### ~ `cookie` Element
The Parser also defines a getter and setter for cookies
###### Example
```javascript
// Set a cookie
c.request.cookie.set({
key: 'my_id',
value: '12345678',
path: '/',
maxAge: 100,
httpOnly: true,
secure: false
})
```
```javascript
// Get a cookie
ctx.request.cookie.get('my_id') => "12345678"
```