# react-fetch-hook [![CircleCI](https://circleci.com/gh/ilyalesik/react-fetch-hook.svg?style=shield)](https://circleci.com/gh/ilyalesik/react-fetch-hook) [![npm version](https://img.shields.io/npm/v/react-fetch-hook.svg)](https://www.npmjs.com/package/react-fetch-hook) [![npm downloads](https://img.shields.io/npm/dt/react-fetch-hook.svg)](https://www.npmjs.com/package/react-fetch-hook) React hook for conveniently use Fetch API. * **Tiny** (556 B). Calculated by [size-limit](https://github.com/ai/size-limit) * Both **Flow** and **TypeScript** types included ```javascript import React from "react"; import useFetch from "react-fetch-hook"; const Component = () => { const { isLoading, data } = useFetch("https://swapi.co/api/people/1"); return isLoading ? (

) : ( ); }; ``` *useFetch* accepts the same arguments as *fetch* function. ## Installation Install it with yarn: ``` yarn add react-fetch-hook ``` Or with npm: ``` npm i react-fetch-hook --save ``` ## Usage ### Custom formatter Default is `response => response.json()` formatter. You can pass custom formatter: ```javascript const { isLoading, data } = useFetch("https://swapi.co/api/people/1", { formatter: (response) => response.text() }); ``` ### Error handling The `useFetch` hook returns an `error` field at any fetch exception. The `error` field extends [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) and has `status` and `statusText` fields equal to [Response](https://developer.mozilla.org/en-US/docs/Web/API/Response). ```javascript ... const Component = () => { const { isLoading, data, error } = useFetch("https://swapi.co/api/people/1"); if (error) { return

Code: ${error.status}

Message: ${error.statusText}

} ... }; ``` ### Multiple requests Multiple `useFetch` in the same file/component supported: ```javascript const result1 = useFetch("https://swapi.co/api/people/1"); const result2 = useFetch("https://swapi.co/api/people/2"); if (result1.isLoading && result2.isLoading) { return

; } return

``` ### Depends The request will not be called until all elements of `depends` array be truthy. Example: ```javascript const {authToken} = useContext(authTokenContext); const [someState, setSomeState] = useState(false); const { isLoading, data } = useFetch("https://swapi.co/api/people/1", { depends: [!!authToken, someState] // don't call request, if haven't authToken OR someState: false }); ``` See [example](examples/depends). ### Re-call requests If any element of `depends` changed, request will be re-call. For example, you can use [react-use-trigger](https://github.com/ilyalesik/react-use-trigger) for re-call the request: ```javascript import createTrigger from "react-use-trigger"; import useTrigger from "react-use-trigger/useTrigger"; const requestTrigger = createTrigger(); export const Subscriber = () => { const requestTriggerValue = useTrigger(requestTrigger); const { isLoading, data } = useFetch("https://swapi.co/api/people/1", { depends: [requestTriggerValue] }); return

; } export const Sender = () => { return } ``` ### usePromise For custom promised function. ```javascript import React from "react"; import usePromise from "react-fetch-hook/usePromise"; import callPromise from "..." const Component = () => { const { isLoading, data } = usePromise(() => callPromise(...params), [...params]); return isLoading ? (

) : ( ); }; ``` ## [Examples](examples) * [Basic](examples/basic) - Just fetch data with `useFetch`. * [Depends](examples/depends) - Usage `depends` option for refresh query. * [Pagination](examples/pagination) - Usage `usePaginationRequest` for infinite scroll implementation. ## API ### `useFetch` Create a hook wrapper for `fetch` call. ```javascript useFetch( path: RequestInfo, options?: { ...RequestOptions, formatter?: Response => Promise depends?: Array }, specialOptions?: { formatter?: Response => Promise depends?: Array } ): TUseFetchResult ``` where `TUseFetchResult` is: ```javascript { data: any, isLoading: boolean, error: any } ``` `RequestInfo`, `RequestOptions` is [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch) args. ### `usePromise` ```javascript usePromise>( callFunction: ?(...args: I) => Promise, ...inputs: I ): TUsePromiseResult ``` where `TUsePromiseResult` is ```javascript type TUsePromiseResult = { data: ?T, isLoading: boolean, error: mixed } ``` ### Experimental: `usePaginatedRequest` ⚠️ Warning: this method is experimental, API can be changed. Create a paginated request. ```javascript usePaginatedRequest = ( request: (params: { limit: number, offset: number }) => Promise>, limit: number, ...depends: Array ): { data: Array, loadMore?: () => mixed, hasMore: boolean }; ``` ## Who Uses react-fetch-hook ### Open Source projects * [react-figma](https://github.com/react-figma/react-figma) * [awesome-web-animation](https://github.com/sergey-pimenov/awesome-web-animation) * [redux-helpers](https://github.com/lecstor/redux-helpers) * [flowmap.blue](https://github.com/FlowmapBlue/flowmap.blue) ### Companies * [Redis Agency](https://redis.agency/) * [Lessmess Agency](https://lessmess.agency) * [BigDatr](https://bigdatr.com/) * [Fabrique numérique des Ministères Sociaux](https://incubateur.social.gouv.fr/) [See more](https://github.com/ilyalesik/react-fetch-hook/network/dependents)

	Stars	Issues	Version	Updated	Created
react-fetch-hook	347	12	1.9.5	2 years ago	5 years ago
react-promise			3.0.2	5 years ago	8 years ago
react-query	39,623	50	3.39.3	a year ago	10 years ago
swr	29,383	110	2.2.5	2 months ago	6 years ago

react-fetch-hook vs react-promise vs react-query vs swr

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past