nookies :cookie:

!Working

> A collection of cookie helpers for Next.js

Features

- ✨ SSR support, for setter, parser and destroy
- ⚙️ Custom Express server support
- 🪶 super light
- 🛡 perfect for authentication

Setting and destroying cookies also works on server-side.

Quick start

yarn add nookies

> You can play with the example code here.

$3

``js
import nookies from 'nookies'

export default function Me() {
return

return { cookies }
}
`

Client-only Cookies

`js
import { parseCookies, setCookie, destroyCookie } from 'nookies'

function handleClick() {
// Simply omit context parameter.
// Parse
const cookies = parseCookies()
console.log({ cookies })

// Set
setCookie(null, 'fromClient', 'value', {
maxAge: 30 24 60 * 60,
path: '/',
})

// Destroy
// destroyCookie(null, 'cookieName')
}

export default function Me() {
return Set Cookie
}
`

Custom Express server cookies

`js
const express = require('express');
const dev = process.env.NODE_ENV !== 'production';
const app = next({ dev });
const handle = app.getRequestHandler();
const { parseCookies, setCookie, destroyCookie } = require('nookies');

app.prepare()
.then(() => {
const server = express();

server.get('/page', (req, res) => {

// Notice how the request object is passed
const parsedCookies = parseCookies({ req });

// Notice how the response object is passed
setCookie({ res }, 'fromServer', 'value', {
maxAge: 30 24 60 * 60,
path: '/page',
});

// destroyCookie({ res }, 'fromServer');

return handle(req, res);
});

);
`

Reference

> For client side usage, omit the ctx parameter. You can do so by setting it to an empty object ({}), null or undefined.

$3

- ctx: Next.js context || (Express request object)
- options:
- decode: a custom resolver function (default: decodeURIComponent)

$3

> Don't forget to end your response on the server with res.send().

- ctx: (Next.js context) || (Express request object)
- name: cookie name
- value: cookie value
- options:
- domain
- encode
- expires
- httpOnly
- maxAge
- path
- sameSite
- secure

$3

> Don't forget to end your response on the server with res.send(). This might be the reason your cookie isn't removed.

- ctx: (Next.js context) || (Express response object)`
- name: cookie name
- options:
- domain
- path

License

MIT