05 Fetch data with React Hooks

在 Reack Hook 中处理网络请求似乎要比 class 组件麻烦一点,毕竟没有 this 实例对象可以在上面封装方法。不要拘束于之前的思维,Hook 的数据请求也许会有更好的方式。

这次我们的实验目标是通过 Github Api 来获取 issues 文章列表,通过传入不同的页码来实现分页。通过实践来研究一下在 hook 中如何优雅地实现数据请求,并在最后封装一个通用的自定义数据请求 hook,以便在今后的项目中复用。

Data Fetching with React Hooks

我们先实现一个简单的函数组件,该组件渲染一个文章列表,并添加一个翻页按钮,每次点击按钮就向下翻一页并向 Github Api 请求文章列表数据。不要问我为什么没有上一页按钮或者分页溢出了怎么办,不要在意这些细节,我们这里只是实验 hook 网络请求,不考虑这种业务细节。

这个功能很简单,如果稍微熟悉 react hook 的使用的话很快就能实现。我们可以先用 useState 初始化文章列表和初始页码,然后使用 useEffect 获取当前页的文章列表,并在页码更新时重新获取文章列表。第一阶段的代码如下:

import React, { useState, useEffect } from 'react'
const GITHUB_API = 'https://api.github.com/repos/chanshiyucx/blog/issues?per_page=10&page='
export default () => {
const [list, setList] = useState([])
const [page, setPage] = useState(1)
useEffect(() => {
const fetchData = async () => {
const url = `${GITHUB_API}${page}`
const response = await fetch(url)
const data = await response.json()
setList(data)
}
fetchData()
}, [page])
const handleNextPage = () => setPage(page + 1)
return (
<div>
<button onClick={handleNextPage}>NextPage</button>
<ul>
{list.map(o => (
<li key={o.id}>{o.title}</li>
))}
</ul>
</div>
)
}

需要注意的是使用 useEffect 的时候第一个函数参数不能是一个异步的 async 函数或者是返回一个 Promise,也就是我们不能像下面这样调用,否则会报出警告:

useEffect(async () => {
const url = `${GITHUB_API}${page}`
const response = await fetch(url)
const data = await response.json()
setList(data)
}, [page])

useEffect function must return a cleanup function or nothing. Promises and useEffect(async () => …) are not supported, but you can call an async function inside an effect.

Add Loading and Error

上面的简易版本已经可以正常工作了,但是有时我们需要在接口请求时处理更多的页面状态。比如将页面置于 loading,并且在网络请求出错时进行错误处理。根据这个需求,我们在第二个版本加入 loading 和 error 处理,并在渲染组件时候根据不同的状态展示不同的内容:

import React, { useState, useEffect } from 'react'
const GITHUB_API = 'https://api.github.com/repos/chanshiyucx/blog/issues?page=10&per_page='
export default () => {
const [list, setList] = useState([])
const [page, setPage] = useState(1)
// 添加 loading 和 error 状态
const [isLoading, setIsLoading] = useState(false)
const [isError, setIsError] = useState(false)
useEffect(() => {
const fetchData = async () => {
setIsError(false)
setIsLoading(true)
try {
const url = `${GITHUB_API}${page}`
const response = await fetch(url)
const data = await response.json()
setList(data)
} catch (error) {
setIsError(true)
}
setIsLoading(false)
}
fetchData()
}, [page])
const handleNextPage = () => setPage(page + 1)
return (
<div>
<button onClick={handleNextPage}>NextPage</button>
<ul>
{list.map(o => (
<li key={o.id}>{o.title}</li>
))}
</ul>
{/* 不同的状态展示不同的提示内容 */}
{isError && <div>Something went wrong ...</div>}
{isLoading && <div>Loading ...</div>}
</div>
)
}

Custom Data Fetching Hook

我们第二版本的数据请求方法已经基本可以满足需求,但是实际业务中数据请求并不只限于一个地方存在,所有往往会封装一个通用的数据请求方法以供多处调用。我们通过 useReducer 对请求进行统一封装,实现一个可重复使用的自定义 hook。最终版代码如下:

import React, { useState, useEffect, useReducer } from 'react'
const GITHUB_API = 'https://api.github.com/repos/chanshiyucx/blog/issues?page=10&per_page='
export default () => {
const [list, setList] = useState([])
const [page, setPage] = useState(1)
const { data, doFetch } = useDataApi(`${GITHUB_API}${page}`, [])
// 翻页时重新获取列表
useEffect(() => doFetch(`${GITHUB_API}${page}`), [page])
useEffect(() => setList(data), [data])
const handleNextPage = () => setPage(page + 1)
return (
<div>
<button onClick={handleNextPage}>NextPage</button>
<ul>
{list.map(o => (
<li key={o.id}>{o.title}</li>
))}
</ul>
{isError && <div>Something went wrong ...</div>}
{isLoading && <div>Loading ...</div>}
</div>
)
}
const dataFetchReducer = (state, action) => {
switch (action.type) {
case 'FETCH_INIT':
return {
...state,
isLoading: true,
isError: false
}
case 'FETCH_SUCCESS':
return {
...state,
isLoading: false,
isError: false,
data: action.payload
}
case 'FETCH_FAILURE':
return {
...state,
isLoading: false,
isError: true
}
default:
throw new Error()
}
}
const useDataApi = (initialUrl, initialData) => {
const [url, setUrl] = useState(initialUrl)
const [state, dispatch] = useReducer(dataFetchReducer, {
isLoading: false,
isError: false,
data: initialData
})
useEffect(() => {
let didCancel = false
const fetchData = async () => {
dispatch({ type: 'FETCH_INIT' })
try {
const response = await fetch(url)
const data = await response.json()
if (!didCancel) {
dispatch({ type: 'FETCH_SUCCESS', payload: data })
}
} catch (error) {
if (!didCancel) {
dispatch({ type: 'FETCH_FAILURE' })
}
}
}
fetchData()
return () => {
didCancel = true
}
}, [url])
const doFetch = url => {
setUrl(url)
}
return { ...state, doFetch }
}

参考文章: React-hooks-fetch-data