mirror of
https://github.com/cupcakearmy/koa-cookie.git
synced 2024-12-22 16:16:29 +00:00
A bit of Docs
This commit is contained in:
parent
bdcf84f686
commit
039b7fb6d0
66
README.md
66
README.md
@ -1,2 +1,68 @@
|
|||||||
# koa-cookie
|
# koa-cookie
|
||||||
Koa Cookie Utility
|
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"
|
||||||
|
```
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user