Package Exports

nookies

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (nookies) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

nookies 🍪 🍪 🍪

A collection of cookie helpers for Next.js

SSR support, for setter, parser and destroy
super light
perfect for authentication

Setting and destroying cookies also works on server-side.

Quick start

npm install --save nookies

Demo

Try a demo of the example code below here:

Demo on CodeSandbox

`getInitialProps` cookies (SSR + Client)

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

export default function Me({ cookies }) {
  return (
    <div>
      My profile. Cookies:
      <ul>
        {cookies &&
          Object.entries(cookies).map(([name, value]) => (
            <li>
              {name}: {value}
            </li>
          ))}
      </ul>
    </div>
  )
}

Me.getInitialProps = async function(ctx) {
  // Parse
  parseCookies(ctx)

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

  // Destroy
  // destroyCookie(ctx, 'cookieName')

  return { cookies };
};

import nookies from 'nookies'

export default function Me () {
  return <div>My profile</div>
}

Me.getInitialProps = async function(ctx) {
  // Parse
  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

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 <button onClick={handleClick}>Set Cookie</button>
}

Reference

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

`parseCookies(ctx, options)` or `cookies.get(ctx, options)`

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

`setCookie(ctx, name, value, options)` or `cookies.set(ctx, name, value, options)`

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

`destroyCookie(ctx, name, options)` or `cookies.destroy(ctx, 'token', options)`

ctx: (Next.js context)
name: cookie name
options:
- domain
- path

License

MIT

nookies