Skip to content

Latest commit

 

History

History

README.md

@opensourceframework/next-cookies

MIT License

Tiny little function for getting cookies on both client & server with next.js.

This enables easy client-side and server-side rendering of pages that depend on cookies.

Installation

pnpm add @opensourceframework/next-cookies

or

npm install @opensourceframework/next-cookies

Usage

Read all cookies:

const allCookies = cookies(ctx);

allCookies will be an object with keys for each cookie.

The ctx object is passed to your getInitialProps function by next.js.

Read a single cookie:

const { myCookie } = cookies(ctx);

or

const myCookie = cookies(ctx).myCookie;

The ctx object is passed to your getInitialProps function by next.js.

Set a cookie:

This library does not support setting cookies. However, this is how to do it in client-side code:

document.cookie = `foo=bar; path=/`;

This sets a cookie named foo to the value bar.

The path portion is optional but usually desired.

An expiration date may be appended (see below), otherwise the cookie will be deleted whenever the browser is closed.

Delete a cookie:

This library does not support deleting cookies. However, this is how to do it in client-side code:

document.cookie = `foo=; path=/; expires=Thu, 01 Jan 1970 00:00:01 GMT`;

The value doesn't matter, although the path does. The expiration date must be in the past.

Complete Example

import React from 'react'
import cookies from '@opensourceframework/next-cookies'

interface NameFormProps {
  initialName: string
}

export default class NameForm extends React.Component<NameFormProps> {
  static async getInitialProps(ctx) {
    return {
      initialName: cookies(ctx).name || ''
    }
  }

  constructor(props: NameFormProps) {
    super(props);
    this.state = { name: props.initialName || '' };
    this.handleChange = this.handleChange.bind(this);
    this.reset = this.reset.bind(this);
  }

  handleChange(event: React.ChangeEvent<HTMLInputElement>) {
    const newName = event.target.value;
    this.setState({ name: newName });
    document.cookie = `name=${newName}; path=/`;
  }

  reset() {
    this.setState({ name: '' });
    document.cookie = 'name=; path=/; expires=Thu, 01 Jan 1970 00:00:01 GMT';
  }

  render() {
    return (
      <div>
        <p>Hi {this.state.name}</p>
        <p>Change cookie: <input
            type="text"
            placeholder="Your name here"
            value={this.state.name}
            onChange={this.handleChange}
          />!
        </p>
        <p>Delete cookie: <button onClick={this.reset}>Reset</button></p>
      </div>
    );
  }
}

TypeScript Support

This package includes TypeScript definitions out of the box.

Attribution

More Information

License

MIT


Maintained by @opensourceframework in the monorepo.