React / 系统课时
提取数据请求逻辑
提取数据请求逻辑
本课将把组件中的请求、加载、错误、取消和刷新逻辑提取为自定义 Hook。页面组件只负责传入地址和渲染结果,同一套请求能力可以在多个列表页复用。
学习目标
- 设计返回数据与操作能力的自定义 Hook
- 在 Hook 内统一处理加载、错误和请求取消
- 通过刷新标记主动重新执行当前请求
确定 Hook 的职责边界
自定义 Hook 适合复用状态逻辑,不负责决定页面长什么样。本课的 useRequest 接收请求地址,返回 data、isLoading、error 和 reload。
Hook 处理通用网络流程;文章字段、空状态文案和列表结构仍由业务组件决定。这样既减少重复,又避免创建一个包含所有页面差异的“大而全”Hook。
实现 useRequest
下面实现会在 URL 变化或调用 reload 后重新请求,并在每轮清理时取消旧请求。
jsx
// src/useRequest.js
import { useCallback, useEffect, useState } from "react";
export function useRequest(url) {
const [data, setData] = useState(null);
const [isLoading, setIsLoading] = useState(false);
const [error, setError] = useState(null);
const [reloadVersion, setReloadVersion] = useState(0);
const reload = useCallback(() => {
setReloadVersion((version) => version + 1);
}, []);
useEffect(() => {
const controller = new AbortController();
async function execute() {
setIsLoading(true);
setError(null);
try {
const response = await fetch(url, {
signal: controller.signal,
});
if (!response.ok) {
throw new Error(`请求失败:${response.status}`);
}
const result = await response.json();
setData(result);
} catch (requestError) {
if (
requestError instanceof DOMException &&
requestError.name === "AbortError"
) {
return;
}
setError(
requestError instanceof Error
? requestError
: new Error("未知请求错误"),
);
} finally {
if (!controller.signal.aborted) {
setIsLoading(false);
}
}
}
execute();
return () => {
controller.abort();
};
}, [url, reloadVersion]);
return { data, isLoading, error, reload };
}该文件是可复用 Hook,不单独产生页面输出。验证方式是由组件调用它,并观察请求状态与刷新行为。
在页面组件中使用
业务组件只处理文章列表自己的展示规则。可选链和空数组回退保证首次请求完成前不会读取 null.map。
jsx
// src/ArticleList.jsx
import { useRequest } from "./useRequest.js";
export default function ArticleList() {
const {
data: articles,
isLoading,
error,
reload,
} = useRequest("/api/articles");
if (isLoading && articles === null) {
return <p>正在加载文章...</p>;
}
if (error) {
return (
<section role="alert">
<p>{error.message}</p>
<button onClick={reload}>重试</button>
</section>
);
}
const articleList = articles ?? [];
if (articleList.length === 0) {
return (
<section>
<p>暂无文章。</p>
<button onClick={reload}>刷新</button>
</section>
);
}
return (
<section>
<h2>文章列表</h2>
<button onClick={reload} disabled={isLoading}>
{isLoading ? "刷新中..." : "刷新"}
</button>
<ul>
{articleList.map((article) => (
<li key={article.id}>{article.title}</li>
))}
</ul>
</section>
);
}预期结果
text
首次进入页面时请求 /api/articles 并显示文章列表。
请求失败时显示错误和“重试”按钮。
点击“刷新”会重新请求同一地址,刷新期间按钮不可用。
组件卸载或 URL 改变时,上一轮请求会被取消。避免不稳定依赖
若 Hook 接收一个在组件渲染时临时创建的函数或对象,它的引用每次都变化,Effect 可能不断重新执行。最简单的做法是传递稳定的字符串 URL 和原始参数。
需要接收请求函数时,应要求调用方用 useCallback 稳定引用,或在 Hook 内明确拆分真正影响请求的依赖。不要为了消除警告而随意删除依赖项,否则 Hook 会使用过期参数。
决定是否继续抽象
当多个页面只有 URL 不同、状态流程一致时,这个 Hook 已足够。若项目还需要缓存、请求去重、失效策略、分页合并和服务端状态同步,应评估成熟的数据请求库,而不是无限扩展单个自定义 Hook。
抽象的判断标准不是“代码能否挪出去”,而是调用方是否因此更清楚,错误处理是否保持一致,扩展成本是否可控。
按自己的节奏,确认真正理解。