cca-koa-cookie

0.1.3 • Public • Published

koa-cookie

Lightweight Koa-Middleware for Cookies

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"

Package Sidebar

Install

npm i cca-koa-cookie

Weekly Downloads

2

Version

0.1.3

License

ISC

Last publish

Collaborators

  • cupcakearmy