Repository files navigation

Handle promises with ease.

React component and hook for declarative promise resolution and data fetching. Makes it easy to handle everystate of the asynchronous process, without assumptions about the shape of your data or the type of request.Use it withfetch, Axios or other data fetching libraries, even GraphQL.

• Zero dependencies
• Works with promises, async/await and the Fetch API
• Now with experimental Suspense support
• Choose between Render Props, Context-based helper components or theuseAsync anduseFetch hooks
• Debug and develop every part of the loading sequence with the React Async DevTools
• Provides convenientisPending,startedAt,finishedAt, et al metadata
• Providescancel andreload actions
• Automatic re-run usingwatch orwatchFn prop
• AcceptsonResolve,onReject andonCancel callbacks
• Supportsabortable fetch by providing an AbortController
• Supports optimistic updates usingsetData
• Supports server-side rendering throughinitialValue
• Written in TypeScript, ships with type definitions
• Works well in React Native too!

Upgrading to v9

Version 9 comes with a minor breaking change.SeeUpgrading for details.

• Introduction

• Installation
• Upgrading
• Usage
• DevTools

• Interfaces
• Configuration options
• State properties
• Helper components

• Async components
• Separating view and logic
• Async actions
• Optimistic updates
• Server-side rendering

• Introduction
• Setting up
• Development
• Testing
• Releasing

Thanks goes to these wonderful people (emoji key):

Gert Hengeveld 💻👀💬	Khartir 💻📦	Lenz Weber 💻📦🤔	Avinash 👀📖	Fred K. Schott 🔧	Cedric van Putten 💻	Tom Shane 👀
Philip Peterson 💻	Sibelius Seraphini 👀	Jim Cummins 👀	Mihkel Sokk 👀	Jiří Brabec 💻	Andrii U 💡	Matthisk Heimensen 💻
Danny Hurlburt 🤔📖	Noel Yoo ⚠️💻🤔	Adam Ratcliffe 💻	Kent C. Dodds 💻	walter-ind 📖	Jacob Lee 💻	Youngrok Kim 💻
Munir Ahmed Elsangedy 🤔	AlixWang 📖	Sal Olivares 💻🐛	Neale Upstone 💻	Martin Barksten 📖

This project follows theall-contributors specification. Contributions of any kind welcome!

• @slorber/react-async-hook
• @dai-shi/react-hooks-async
• @cristovao-trevisan/async-resource
• @ilyalesik/react-fetch-hook
• @marcin-piela/react-fetching-library