React 自定义 Hook 最佳实践：示例用例

查看原始帖子 https://devaradise.com/react-custom-hooks-best-practices/ 以阅读目录

如果您是 React 开发人员，您可能遇到过需要跨组件共享逻辑的情况。在这篇文章中，我们将探讨什么是自定义钩子、何时使用它们、编写它们的最佳实践，以及一些使您的 React 应用程序更干净、更易于维护的常见用例。

有关 React 的相关帖子

1. 如何在 2024 年启动和设置 React 项目
2. 使用 Hooks 反应函数组件
3. React 条件渲染（If Else）最佳实践

React 中的自定义 Hook 是什么？

自定义钩子是一个可重用的函数，具有可在 React 组件之间共享的状态逻辑。它们从前缀 use 开始，可以调用其中的其他钩子，从而可以将复杂的状态和效果逻辑抽象为简单的、可重用的函数。

React 自定义挂钩非常适合需要在应用程序的不同部分之间共享逻辑而不重复代码的情况。这不仅可以使您的组件保持干净，还可以促进更加模块化的代码库。

请注意，自定义钩子与常规 JavaScript 可重用函数不同。自定义钩子是有状态的，这意味着您应该将 React State 与 useState 钩子或其他内置钩子一起使用。

何时在 React 中使用自定义 Hook

每当您需要跨组件重用状态逻辑时，自定义挂钩都是非常适合的，特别是对于数据获取、表单处理和身份验证等复杂任务。它们简化了组件代码，增强了可读性，并使测试和维护变得更加容易。

自定义挂钩的另一个主要用例是当您发现自己在多个地方编写相同的代码时。您可以将其提取到自定义挂钩中并在需要的地方重用，而不是复制和粘贴相同的逻辑。这提倡 DRY（不要重复自己）原则，使您的代码库更加高效且不易出错。

编写自定义 Hook 的最佳实践

创建自定义挂钩时，需要牢记一些最佳实践，以确保它们有效且可维护。以下是一些关键准则：

1.从使用开始

自定义挂钩的名称始终以 use 开头。这是一个约定，可以帮助其他 React 开发人员将这些函数识别为钩子，确保正确应用钩子规则。

2. 保持 Hooks 纯粹

确保你的钩子是纯函数。避免直接在钩子内部产生副作用；相反，使用 useEffect 或类似的钩子来管理它们。

副作用是渲染后组件中发生的任何操作或行为，并且不会直接影响当前组件渲染周期。

3. 避免不必要的渲染

使用 useMemo 或 useCallback 等记忆技术来防止钩子导致不必要的重新渲染，特别是在处理昂贵的计算或复杂的状态更新时。

利用内置钩子（例如 useState、useEffect、useReducer 和 useCallback）来管理自定义钩子内的状态和副作用。

4.返回一致的值类型

从包含状态、函数或您想要公开的任何值的钩子中返回具有一致值类型的数组或对象。这清楚地表明了该钩子提供了什么以及如何使用它。

5. 编写测试并记录您的自定义 Hook

确保您的自定义挂钩经过充分测试。使用 React 测试库和 Jest 等工具编写测试来验证钩子的行为。

为您的自定义挂钩提供清晰的文档。解释它们的作用、参数和返回值，以便其他人（和您自己）更容易使用和维护。

6. 保持简单

避免让你的钩子过于复杂。如果一个钩子开始变得太复杂，请考虑将其分解为更小、更集中的钩子。

确保你的钩子只承担单一责任。

7. 优雅地处理错误

在你的钩子内优雅地处理错误。这确保使用这些钩子的组件可以处理意外场景而不会中断。

自定义 Hook 的示例用例

以下是您在 React 项目中可能会遇到的自定义钩子的一些常见用例：

1. 数据获取

用于从 API 端点获取数据的自定义挂钩可以在需要获取和显示数据的不同组件之间重用。

import { useState, useEffect } from 'react';

function useFetch(url) {
    const [data, setData] = useState(null);
    const [loading, setLoading] = useState(true);
    const [error, setError] = useState(null);

    useEffect(() => {
        async function fetchData() {
            try {
                const response = await fetch(url);
                if (!response.ok) {
                    throw new Error('Network response was not ok');
                }
                const result = await response.json();
                setData(result);
            } catch (err) {
                setError(err);
            } finally {
                setLoading(false);
            }
        }

        fetchData();
    }, [url]);

    return { data, loading, error };
}

const Component = () => {
    const { data, loading, error } = useFetch('https://example.com/api/path');

    if (loading) return <div>Loading...</div>;
    if (error) return <div>Error: {error.message}</div>;

    return (
        <div>
            <h1>Data:</h1>
            <pre class="brush:php;toolbar:false">{JSON.stringify(data)}