react-hook-action
_react-hook-action_ is a lightweight React hook for managing asynchronous actions and their loading states, safely resolving promises and globally persisting states using Zustand.
---
- [Installation](#-installation)
- [Usage](#-usage)
- [Documentation](#-documentation)
- [Contributing](#-contributing)
- [License](#license)
## 📦 Installation
```bash
npm install react-hook-action
```
Install using your favorite package manager
**pnpm**
```bash
pnpm install react-hook-action
```
**yarn**
```bash
yarn add react-hook-action
```
## 📖 Usage
### Basic Usage
Wrap any asynchronous function to automatically manage `isLoading`, `result`, and `error` states.
```tsx
import { useAction } from 'react-hook-action';
export default function Page() {
const { result, error, isLoading, dispatch, reset } = useAction(
'fetchUser',
async (id: number) => {
const response = await fetch(`https://api.example.com/users/${id}`);
if (!response.ok) throw new Error('Failed to fetch user');
return response.json();
}
);
if (isLoading) {
return Loading...
;
}
if (error) {
return Error: {error.message}
;
}
return (
{result &&
User: {result.name}
}