iArnaud / nookies

🍪 A set of cookie helpers for Next.js

nookies 🍪 🍪 🍪

A collection of cookie helpers for Next.js

• SSR support, for setter, parser and destory
• super light
• perfect for authentication

Setting and destorying cookies also works on server-side.

Quick start

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

export default class Me extends React.Component {
  static async getInitialProps(ctx) {
    // Parse
    parseCookies(ctx)

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

    // Destory
    destroyCookie(ctx, 'token')
  }

  render() {
    return <div>My profile</div>
  }
}

OR

import nookies from 'nookies'

export default class Me extends React.Component {
  static async getInitialProps(ctx) {
    // Parse
    nookies.get(ctx)

    // Set
    nookies.set(ctx, 'token', token, {
      maxAge: 30 * 24 * 60 * 60,
      path: '/',
    })

    // Destory
    nookies.destroy(ctx, 'token')
  }

  render() {
    return <div>My profile</div>
  }
}

Reference

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) or cookies.destroy(ctx, 'token')

• ctx: (Next.js context)
• name: cookie name

License

MIT