https://github.com/maticzav/nookies
🍪 A set of cookie helpers for Next.js
https://github.com/maticzav/nookies
cookie hacktoberfest nextjs react zeit
Last synced: 10 months ago
JSON representation
🍪 A set of cookie helpers for Next.js
- Host: GitHub
- URL: https://github.com/maticzav/nookies
- Owner: maticzav
- Created: 2018-01-16T00:32:30.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-02-13T10:38:46.000Z (about 1 year ago)
- Last Synced: 2025-05-12T13:18:19.011Z (10 months ago)
- Topics: cookie, hacktoberfest, nextjs, react, zeit
- Language: TypeScript
- Homepage:
- Size: 50.4 MB
- Stars: 2,333
- Watchers: 10
- Forks: 78
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- Awesome-NextJs - nookies - `A set of cookie helpers for Next.js` (miscellaneous)
- awesome-list - nookies
- stars - nookies
README
# nookies :cookie:
[](https://badge.fury.io/js/nookies)
> 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](https://codesandbox.io/s/charming-herschel-7z362).
### ServerSide cookies
```js
import nookies from 'nookies'
export default function Me() {
return
My profile
}
export async function getServerSideProps(ctx) {
// Parse
const cookies = nookies.get(ctx)
// Set
nookies.set(ctx, 'fromGetInitialProps', 'value', {
maxAge: 30 * 24 * 60 * 60,
path: '/',
})
// Destroy
// nookies.destroy(ctx, 'cookieName')
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`.
### `parseCookies(ctx, options)` or `nookies.get(ctx, options)`
- **ctx:** `Next.js context` || `(Express request object)`
- **options:**
- **decode:** `a custom resolver function (default: decodeURIComponent)`
### `setCookie(ctx, name, value, options)` or `nookies.set(ctx, name, value, options)`
> 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**
### `destroyCookie(ctx, name, options)` or `nookies.destroy(ctx, 'token', options)`
> 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