/** * @file react 组件生命周期相关 hooks */ import { EffectCallback, useEffect } from 'react'; /** * 只在组件挂载 (首次渲染) 时执行该 effect, 组件后续的刷新不会再触发该 effect. * 如果该 effect 返回了一个清理函数, 那么它也只会在组件销毁时执行. * * @param effect - 要执行的 effect, 类型同 useEffect 的参数 * * @example * ```javascript * useOnMount(() => { * addEventListener(handler) * return () => removeEventListener(handler) * }) * ``` */ export declare const useOnMount: (effect: EffectCallback) => void; /** * 组件首次渲染时不执行 effect, 只在后续 deps 变化时执行. * * @param effect - 要执行的 effect, 类型同 useEffect 的参数 * @param deps - 同 useEffect 的 deps */ export declare const useOnUpdate: typeof useEffect; /** * 返回一个强制更新函数, 通常用于作为 useEffect 的依赖项, 然后通过执行自己来强制触发 useEffect 更新. * 由于该函数通常不在 useEffect 的函数体内出现, 会被 eslint 上报为多余的依赖项, * 往往需要添加 `// eslint-disable-next-line react-hooks/exhaustive-deps` 来阻止 eslint 报错. * * @returns 返回 [上述函数, 内部 token 值 (从 0 开始, 每执行一次 +1)] * * @example * ```javascript * const [update] = useForceUpdate() * * React.useEffect(() => * api.queryLoad() * }, [update]) * * * ``` */ export declare const useForceUpdate: () => readonly [() => void, number]; /** * 返回一个标志位,当依赖变化时,重新构造组件。 * 通常用于底层数据变化时(比如切换了用户),直接重新构造底层组件,以达到重新请求接口数据和渲染的效果。 * 这种方法,比让底层组件的子组件 Hook 逐个观测底层数据的变化而言,更为简单和易维护。 * * @param dep - 依赖 * @returns 渲染标志 */ export declare const useRecreateOn: (dep: boolean | number | string) => boolean;