@shopify/react-cookie
Cookies in React for the server and client
Last updated 21 days ago by shopify-dep .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @shopify/react-cookie 
SYNC missed versions from official npm registry.

@shopify/react-cookie

Build Status License: MIT npm version npm bundle size (minified + gzip)

Cookies in React for the server and client.

Installation

$ yarn add @shopify/react-cookie

Usage

Server

To extract cookies during the server-side render of your application, your component needs to have access to the NetworkManager from @shopify/react-network. You can pass the initial server cookie value when the manager is instantiated within your server-side middleware.

For full details on setting up @shopify/react-network, see the readme for that package.

Koa Server Example

import React from 'react';
import {render} from '@shopify/react-html/server';
import {extract} from '@shopify/react-effect/server';
import {
  NetworkManager,
  NetworkContext,
  applyToContext,
} from '@shopify/react-network/server';
import App from './App';

export default function renderApp(ctx: Context) {
  const networkManager = new NetworkManager({
    // Here we provide the server cookies
    cookies: ctx.request.headers.cookie || '',
  });

  const app = <App />;

  await extract(app, {
    decorate: element => (
      <NetworkContext.Provider value={networkManager}>
        {element}
      </NetworkContext.Provider>
    ),
  });

  applyToContext(ctx, networkManager);

  ctx.body = render(
    <NetworkContext.Provider value={networkManager}>
      {app}
    </NetworkContext.Provider>,
  );
}

Client

To use the useCookie() hook provided by this library, you must first wrap your client-side application tree in the <CookieUniversalProvider /> component.

React App Provider Example

// App.tsx

import {CookieUniversalProvider} from '@shopify/react-cookie';
import {SomeComponent} from './someComponent'; // see `hooks` example below

function App() {
  <CookieUniversalProvider>
    // rest of your tree
    <SomeComponent />
  </CookieUniversalProvider>;
}

Hooks

useCookie(name: string)

This hook is called with the name of a given cookie and returns the current value and a setter for that cookie. If the setter is called without a value argument, it will remove the cookie.

React Hook Example

// SomeComponent.tsx

import React from 'react';
import {useCookie} from '@shopify/react-cookie';

function SomeComponent() {
  const [cookie, setCookie] = useCookie('fooCookie');
  const handleChange = event => setCookie(event.target.value);
  const removeCookie = () => setCookie();

  return (
    <>
      <p>the cookie is {cookie}</p>
      <TextField value={cookie} onChange={handleChange} />
      <button type="button" onClick={removeCookie}>
        Remove Cookie
      </button>
    </>
  );
}

Utilities

createCookies()

This utility can be used to create an initial set of cookies in the document.cookie. This can be useful in test set up.

clearCookies()

This utility can be used to clear a set of cookies from the document.cookie. This can be useful when you need to clear the cookies between tests, such as in an afterEach block.

Current Tags

  • 0.0.11                                ...           latest (21 days ago)

11 Versions

  • 0.0.11                                ...           21 days ago
  • 0.0.10                                ...           a month ago
  • 0.0.9                                ...           a month ago
  • 0.0.8                                ...           a month ago
  • 0.0.7                                ...           a month ago
  • 0.0.6                                ...           2 months ago
  • 0.0.5                                ...           2 months ago
  • 0.0.4                                ...           2 months ago
  • 0.0.3                                ...           2 months ago
  • 0.0.1                                ...           2 months ago
  • 0.0.2                                ...           2 months ago
Downloads
Today 0
This Week 11
This Month 11
Last Day 0
Last Week 0
Last Month 49
Dependencies (6)
Dev Dependencies (0)
None
Dependents (1)

Copyright 2014 - 2016 © taobao.org |