jotai-mutative
v1.0.2
Published
A Mutative extension for Jotai
Downloads
912
Maintainers
Readme
jotai-mutative
A Mutative extension for Jotai
With the Mutative extension, you can simplify the handling of immutable data in Jotai in a mutable way, allowing you to use immutable state more conveniently.
jotai-mutative
is more than 10x faster than jotai-immer
. Read more about the performance comparison in Mutative.
Installation
In order to use the Mutative extension in Jotai, you will need to install Mutative and Jotai as a direct dependency.
npm install jotai mutative jotai-mutative
# Or use any package manager of your choice.
Usage
atomWithMutative
atomWithMutative
creates a new atom similar to the regular atom with a different writeFunction
. In this bundle, we don't have read-only atoms, because the point of these functions is the mutative create(mutability) function. The signature of writeFunction is (get, set, update: (draft: Draft<Value>) => void) => void
.
import { useAtom } from 'jotai';
import { atomWithMutative } from 'jotai-mutative';
const countAtom = atomWithMutative({ value: 0 });
const Counter = () => {
const [count] = useAtom(countAtom);
return <div>count: {count.value}</div>;
};
const Controls = () => {
const [, setCount] = useAtom(countAtom);
// setCount === update : (draft: Draft<Value>) => void
const inc = () =>
setCount((draft) => {
++draft.value;
});
return <button onClick={inc}>+1</button>;
};
withMutative
withMutative
takes an atom and returns a derived atom, same as atomWithMutative
it has a different writeFunction
.
import { useAtom, atom } from 'jotai';
import { withMutative } from 'jotai-mutative';
const primitiveAtom = atom({ value: 0 });
const countAtom = withMutative(primitiveAtom);
const Counter = () => {
const [count] = useAtom(countAtom);
return <div>count: {count.value}</div>;
};
const Controls = () => {
const [, setCount] = useAtom(countAtom);
// setCount === update : (draft: Draft<Value>) => void
const inc = () =>
setCount((draft) => {
++draft.value;
});
return <button onClick={inc}>+1</button>;
};
useMutativeAtom
This hook takes an atom and replaces the atom's writeFunction
with the new mutative-like writeFunction
like the previous helpers.
import { useAtom } from 'jotai';
import { useMutativeAtom } from 'jotai-mutative';
const primitiveAtom = atom({ value: 0 });
const Counter = () => {
const [count] = useMutativeAtom(primitiveAtom);
return <div>count: {count.value}</div>;
};
const Controls = () => {
const [, setCount] = useMutativeAtom(primitiveAtom);
// setCount === update : (draft: Draft<Value>) => void
const inc = () =>
setCount((draft) => {
++draft.value;
});
return <button onClick={inc}>+1</button>;
};
It would be better if you don't use
withMutative
andatomWithMutative
withuseMutativeAtom
because they provide the mutative-likewriteFunction
and we don't need to create a new one. You can useuseSetMutativeAtom
if you need only the setter part ofuseMutativeAtom
.
Mutative Options
Credits
jotai-mutative
is inspired by jotai-immer
.
It uses the same API as jotai-immer
but uses Mutative under the hood. The repository is based on the jotai-immer
repository.
License
jotai-mutative
is MIT licensed.