diff --git a/README.md b/README.md index 2784c68..59ce040 100644 --- a/README.md +++ b/README.md @@ -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" +``` +