recoil-nexus
TypeScript icon, indicating that this package has built-in type declarations

0.5.0 • Public • Published

R E C O I L - N E X U S

If you have been using recoil for a while, you might have faced that outside React Components it's not possible to get or update values from atoms.

This Typescript implementation will workaround the issue and let you do so.

Live Example

Install

npm

npm i recoil-nexus

yarn

yarn add recoil-nexus

Usage

1. Add RecoilNexus in your RecoilRoot

import React from "react";
import { RecoilRoot } from "recoil";
import RecoilNexus from "recoil-nexus";

export default function App() {
  return (
    <RecoilRoot>
      <RecoilNexus />

      {/* ... */}
    </RecoilRoot>
  );
}

export default App;

2. Use the following methods to get/set values passing your atom as a parameter.

Method Returns
getRecoil getter function
getRecoilPromise getter function, returns a promise. To be used with asynchronous selectors.
setRecoil setter function, pass value to be set as second parameter
resetRecoil pass atom as parameter to reset to default value
// Loading example
import { loadingState } from "../atoms/loadingState";
import { getRecoil, setRecoil } from "recoil-nexus";

export default function toggleLoading() {
  const loading = getRecoil(loadingState);
  setRecoil(loadingState, !loading);
}
//Loader
import React from "react";
import { useRecoilValue } from "recoil";

export default function Loader() {
  loading = useRecoilValue(loadingState);
  return loading ? <h3>Loading...</h3> : null;
}
//Atom
import { atom } from "recoil";

export const loadingState = atom({
  key: "LOADING",
  default: false,
});

Test Setup

Jest

When testing in Jest, we need to set "transformIgnorePatterns": [] in our jest config, otherwise a SyntaxError: Cannot use import statement outside a module will cause the tests to fail. This can be acheived one of the following ways, depending on how you are defining your jest config:

export default config
  • in jest.config.js
"transformIgnorePatterns": []
  • in the top level of the package.json
"jest": {
  "transformIgnorePatterns": []
},

Credits

Kudos to VeepCream's recoil-outside original idea and Javascript implementation.
In this Typescript port/enhancement, I decided to remove RxJS and rely on native Recoil promises and loadables only.

Dependencies (0)

    Dev Dependencies (0)

      Package Sidebar

      Install

      npm i recoil-nexus

      Weekly Downloads

      17,334

      Version

      0.5.0

      License

      MIT

      Unpacked Size

      11 kB

      Total Files

      8

      Last publish

      Collaborators

      • luis.antonio