A Tiny Custom React hooks for making request.
- 👕 Typescript support.
- 🗜️ 1.3kb after minified without gzip.
- 📤 Easy to use with different request client.
yarn add @rekindle/use-request
import useRequest from '@rekindle/use-request'
import getFooApi from '@/utils/axios'
function App () {
const [{ loading, error, data }, fetch] = useRequest(getFooApi)
useEffect(() => { fetch() }, [fetch])
if (loading) return 'loading'
if (error) return 'error'
return data && <div>{data}</div>
}
Queries are typically start with loading, we can create a
useQuery
function before we use.
function useQuery (api) {
return useRequest(api, { loading: true })
}
function Query () {
const [{ loading, error, data }, fetch] = useQuery(queryFooApi)
useEffect(() => { fetch() }, [fetch])
if (loading) return 'loading...'
if (error) return 'error'
// no need to check data
return <div>{data}</div>
}
function MultiQuery () {
const [foo, fetchFoo] = useQuery(queryFooApi)
const [bar, fetchBar] = useQuery(queryBarApi)
useEffect(() => {
fetchFoo()
fetchBar()
}, [fetchFoo, fetchBar])
const renderContent = (state) => {
const { loading, error, data } = state
if (loading) return 'loading...'
if (error) return 'error'
return <div>{data}</div>
}
return (
<div>
{renderContent(foo)}
{renderContent(bar)}
</div>
)
}
function BatchQuery () {
const batchFetchApi = () => Promise.all([queryFooApi(), queryBarApi()])
const [{ loading, error, data }, fetch] = useQuery(batchFetchApi)
useEffect(() => { fetch() }, [fetch])
if (loading) return 'loading...'
if (error) return 'error'
const [foo, bar] = data
return (
<div>
<div>{foo}</div>
<div>{bar}</div>
<button onClick={fetch}>refetch batch</button>
</div>
)
}
function Mutate () {
const [{ loading, error, data }, mutate] = useRequest(mutateBazApi)
const [value, setValue] = useState('')
useEffect(() => {
if (error) alert('error')
if (data === 'success') alert('success')
}, [error, data])
return (
<div>
<input value={value} onChange={(e) => setValue(e.target.value)} />
<button disabled={loading} onClick={() => mutate(value)}>submit</button>
</div>
)
}
type useRequest = (api, initialState) => [state, memoizedRequestCallback]
Notice: Why momoized request callback ?
Reference: Is it safe to omit functions from the list of dependencies?
If you want a deep dive on useEffect and dependencies, it's here: https://overreacted.io/a-complete-guide-to-useeffect/
PR & issue welcome.
MIT