安全地使用 React Hooks 和 TypeScript

阅读时长 12 分钟读完

React Hooks 和 TypeScript 是目前前端领域最热门的技术之一。React Hooks 带来了全新的组件状态管理方案,而 TypeScript 则为前端代码的类型安全提供了便捷的解决方案。但是在使用 React Hooks 和 TypeScript 过程中,亦存在一些潜在的问题,例如使用 Hooks 的正确性及类型相关的问题。本文将会详细介绍如何安全地使用 React Hooks 和 TypeScript。

React Hooks 的正确使用

Hooks 是 React 16.8 引入的新特性,它允许在不编写 class 的情况下使用 state 以及其他的 React 特性。Hooks 可以让 React 中的代码更简洁、可复用且易于组合。

useState 和 useReducer

useState 和 useReducer 是 React Hooks 中最常用的两个 Hooks。使用这两个 Hooks 时,需要保证以下几点:

  • 以一个函数式组件为基础,Hook 只能在顶级组件中进行调用;
  • 不能在循环体或条件语句等有很多分支的地方调用 Hook;
  • useState 和 useReducer 的初始状态必须与组件渲染一致;
  • 无法在 class 组件或普通函数中调用 useState 和 useReducer。

下面是一个使用 useState 的示例代码:

-- -------------------- ---- -------
------ ------ - -------- - ---- --------

--------- ----- -
  ------ -------
-

----- -------------- --------------- - -- ----- -- -- -
  ----- ------- --------- - --------------------

  ------ -
    -----
      ----------------
      ---
        ------ -------
        ------- ----------- -- -------------- - --------------
      ----
    ------
  --
--

需要注意的是,上述示例代码中定义的 useState 泛型参数指定了 count 的类型为 number。这种方式可以确保使用 count 时类型的正确性。

useEffect 和 useLayoutEffect

useEffect 和 useLayoutEffect 主要用于在组件中执行副作用操作。这两个 Hooks 的主要区别是,useLayoutEffect 会在 DOM 更新之前同步执行,而 useEffect 则是在 DOM 更新之后异步执行。

使用 useEffect 和 useLayoutEffect 时,需要确保以下几点:

  • 副作用操作必须是纯函数,即完全根据输入返回输出,不产生任何副作用;
  • 副作用操作必须保证可重入性,即多次调用结果与单次调用结果相同;
  • 副作用操作必须保证无副作用,即与组件本身无关的操作应该避免在这里执行。

下面是一个使用 useEffect 和 useRef 的示例代码:

-- -------------------- ---- -------
------ ------ - ---------- ------ - ---- --------

--------- ----- -
  ---- -------
-

----- ------------ --------------- - -- --- -- -- -
  ----- -------- - -------------------------------

  ------------ -- -
    ----- ----- - -----------------
    -- ------- -
      --------- - ----
      ------------------------------ -- -- -
        ------------------ ------ ----------
        -- -- ---------
      ---
      ------ -- -- ----------------------------------
    -
  -- -------

  ------ ---- -------------- ---
--

useCallback 和 useMemo

useCallback 和 useMemo 用于性能优化,主要避免一些无意义的渲染。useCallback 和 useMemo 的参数都是一个函数和一个依赖项数组,依赖项数组会影响到返回值的更新。

下面是一个使用 useCallback 和 memo 的示例代码:

-- -------------------- ---- -------
------ ------ - --------- ------------ ---- - ---- --------

--------- ----- -
  ------ -------
  -------- ------ ------ -- -----
-

----- --------- --------------- - ------- ------ ------- -- -- -
  ----- ------ ------------- - --------------------

  ----- --------- - -------------- -- -
    ----------------------------------------------
      ----------- -- -----------
      ------------ -- -
        -------------------
        --------------
      ---
  -- ------- ----------

  ------ -
    -----
      ------------------
      ------- ------------------------- -------------
      ----
        ---------------- -- -
          --- ------------------------------
        ---
      -----
    ------
  --
---

可以看到,上述代码使用 useCallback 来避免 fetchData 的重新声明与计算,以便在依赖项数组未变化时跳过 useEffect 和子组件的重新渲染。

useImperativeHandle 和 forwardRef

useImperativeHandle 和 forwardRef 通常用于组件间的通讯。其中 useImperativeHandle 可以为函数式组件提供一个可选的 ref 参数,使得父组件能够像操作 class 组件一样操作函数式组件;而 forwardRef 则可以让父组件直接访问子组件中的 DOM 节点或组件实例。

下面是一个使用 useImperativeHandle 和 forwardRef 的示例代码:

-- -------------------- ---- -------
------ ------ - -------------------- ---------- - ---- --------

--------- ----- -
  ------ -------
  -------------- ------- ------- -- -----
-

------ --------- -------- -
  --------- -- -- -------
  --------- ------- ------- -- -----
-

----- ------ --------------- - -----------
  -- ------ ------------- -- ---- -- -
    ----- ------------ -------------- - ------------------------

    ------------------------ -- -- --
      --------- -- -- -----------
      --------- ------- -- ---------------------
    ----

    ------ -
      ------
        -----------
        ------------------
        ------------- -- -
          ------------------------------
          ------------------------------
        --
      --
    --
  -
--

----- ---- -------- - -- -- -
  ----- -------- - -----------------------

  ----- ----------- - -- -- -
    -- ------------------ -
      ----- ----- - ----------------------------
      ------------------ ----- -- -----------
      ------------------------------
    -
  --

  ------ -
    -----
      ------
        --------
        ---------------------- -- -
          ------------------ ----- ------- -- -----------
        --
        --------------
      --
      ------- ------------------------- --------------
    ------
  --
--

需要注意的是,上述代码中的 Input 组件必须使用 forwardRef 包装,以便接收父组件传递而来的 ref 参数。

TypeScript 与 React Hooks 的结合

在 TypeScript 中使用 React Hooks 的过程中,需要解决以下两个问题:

  • 如何在类型定义中指定 Hook 的泛型参数;
  • 如何避免 TS 中针对 undefined 变量的运行时错误。

指定 Hook 泛型参数

有时需要在一个组件中同时使用多个 useState 或 useReducer,这时需要指定对应的泛型参数数组。需要注意的是,这些泛型参数数组顺序应该与 useState 或 useReducer 的调用顺序相同。如果使用泛型变量,则需要先在组件定义之前把相应的类型定义在整个文件中。

下面是一个使用泛型变量的示例代码:

-- -------------------- ---- -------
------ ------ - -------- - ---- --------

--------- -------- -
  --- -------
  ------ -------
  ---------- --------
-

--------- ----- --

---- -------- - ------------ --------------------------------------------------

----- ----- --------------- - -- -- -
  ----- ---------- ------------- -------- - ----------------------- -----

  ----- ----------------- - ------- ------- -- -
    ------------------- -- -
      ---------
      -
        --- ------------ - --
        ------
        ---------- ------
      --
    ---
  --

  ------ -
    -----
      ------------ --------------------------------- --
      ------------- -------------------- --
    ------
  --
--

需要注意的是,上述代码中的用法并不是最好的实现方式,只是为示例而设。实际使用中,应该考虑将状态管理移到专门的 hook 中,以便更好地复用。

避免运行时错误

在开发 React 应用时,一个常见的问题是,TS 无法完全准确地推导出变量类型。下面是一个常见的示例:

-- -------------------- ---- -------
------ ------ - -------- - ---- --------

-------- -------------- ------------------ -
  ----- -------------- ---------------- - ----------------

  ------ -
    ------- ----------- -- --------------------------------
      ------------- - ------ - ------- -----
    ---------
  --
-

上述代码中,由于我们没有明确告诉 TS setIsAlertShown 变量的类型,它无法推断出变量是否为 undefined 或如何初始化变量。因此,当使用该变量时,编译器会抛出一个 undefined 错误。

要解决这个问题,我们可以使用可选链(?)来访问变量。同时,我们可以使用 non-null assert(!)操作符告诉 TS 变量不会为 undefined。

-- -------------------- ---- -------
-------- -------------- ------------------ -
  ----- -------------- ---------------- - -------------------------

  ------ -
    ------- ----------- -- --------------------------------
      ------------- - ------ - ------- -----
    ---------
  --
-

在上面的示例中,使用了 useState<boolean>(false) 来告诉 TS 变量的类型为 boolean,并且它有一个初始值为 false。这个明确的类型声明允许 TS 在使用变量时正确地推断其类型,并避免运行时错误。

总结

React Hooks 和 TypeScript 可以搭配使用,提高前端代码的可维护性和健壮性。在使用过程中,需要注意 Hooks 的正确性和类型定义上的问题。我们需要遵循 Hooks 的使用规范以及在使用 Hooks 时正确指定泛型参数和类型定义,以避免出现运行时错误。除此之外,我们可以使用各种技巧和工具,如可选链和 non-null assert 操作符来提高代码的可靠性和类型安全性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/64c5d97b95c405902ee39058

纠错
反馈