Skip to content

async-library/react-async

Repository files navigation

React Async
Handle promises with ease.


latest version montly downloads minzipped size license
circleci status travis status code coverage code quality DeepScan grade
live examples Chromatic All Contributors

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

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

๐Ÿ“–

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

Similar projects