Handle promises with ease.

React component and hook for declarative promise resolution and data fetching. Makes it easy to handle every state of the asynchronous process, without assumptions about the shape of your data or the type of request. Use it with fetch, 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 the useAsync and useFetch hooks
Debug and develop every part of the loading sequence with the React Async DevTools
Provides convenient isPending, startedAt, finishedAt, et al metadata
Provides cancel and reload actions
Automatic re-run using watch or watchFn prop
Accepts onResolve, onReject and onCancel callbacks
Supports abortable fetch by providing an AbortController
Supports optimistic updates using setData
Supports server-side rendering through initialValue
Written in TypeScript, ships with type definitions
Works well in React Native too!

Upgrading to v9

Version 9 comes with a minor breaking change. See Upgrading for details.

Documentation

Introduction

Getting started

API

Guide

Contributing

Contributors

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} 📖