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。

抽象的判断标准不是“代码能否挪出去”,而是调用方是否因此更清楚,错误处理是否保持一致,扩展成本是否可控。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提取数据请求逻辑

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通