koa-cookie/README.md

koa-cookie

Lightweight Koa-Middleware for Cookies

Install

npm install cca-koa-cookie --save

QA

If you have questions:

Complete Example

const
	Koa = require('koa'),
	cookie = require('cca-koa-cookie'),
	router = require('cca-koa-router')

const
	app = new Koa(),
	port = 3000

app.use(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 = 'Cookie Set'
	})

	_.get('/get', (c, n) => {
		c.body = 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

// Set a cookie
ctx.request.cookie.set({
	key: 'my_id',
	value: '12345678',
	path: '/',
	maxAge: 100,
	httpOnly: true,
	secure: false
})

Options	Value
Key	Cookie Name
Value	Cookie Value
Path	Url Path
Domain	Sub or Domain
httpOnly	bool
secure	bool
max-age	seconds after the cookie expres

// Get a cookie
ctx.request.cookie.get('my_id') => "12345678"