React ahooks——副作用类hooks之useThrottleEffect

useThrottleEffect 是 ahooks 提供的节流版**useEffect**,它在依赖项变化时执行副作用函数,但会限制执行频率。

一、基本语法

javascript 复制代码
useThrottleEffect(
  effect: React.EffectCallback,
  deps?: React.DependencyList,
  options?: Options
)

二、参数详解

2.1. effect (必需)

副作用函数,与 useEffect 的第一个参数相同,可以返回一个清理函数。

2.2 deps (可选)

依赖数组,与 useEffect 的第二个参数相同。当数组中的值发生变化时,会触发节流判断。

2.3. options (可选)

配置对象,包含以下属性:

属性名 类型 默认值 描述
wait number 1000 节流等待时间,单位毫秒
leading boolean true 是否在节流开始前立即执行
trailing boolean true 是否在节流结束后执行
maxWait number - 最大等待时间,保证至少每隔这个时间执行一次

三、使用示例

3.1 基础用法

javascript 复制代码
import { useThrottleEffect } from 'ahooks';
import { useState } from 'react';

function SearchComponent() {
  const [keyword, setKeyword] = useState('');

  useThrottleEffect(
    () => {
      // 这里执行搜索API调用或其他副作用
      console.log('搜索关键词:', keyword);
      // mock API call
      // fetch(`/api/search?q=${keyword}`).then(...);
    },
    [keyword], // 依赖项
    { wait: 500 } // 500ms内只执行一次
  );

  return (
    <input
      value={keyword}
      onChange={(e) => setKeyword(e.target.value)}
      placeholder="输入搜索内容..."
    />
  );
}

3.2 高级配置示例

javascript 复制代码
useThrottleEffect(
  () => {
    console.log('高级节流效果:', value);
    // 执行一些计算量大的操作
  },
  [value],
  {
    wait: 300,
    leading: false, // 不立即执行第一次
    trailing: true, // 最后一次变化后执行
    maxWait: 2000   // 确保至少每2秒执行一次
  }
);

3.3 与清理函数结合示例

javascript 复制代码
useThrottleEffect(
  () => {
    const timer = setTimeout(() => {
      console.log('延迟执行的操作');
    }, 100);

    return () => {
      clearTimeout(timer); // 清理函数
    };
  },
  [dependency],
  { wait: 500 }
);
相关推荐
deli00710 分钟前
TCP 为什么会粘包?4 种拆包方案 49 字节实测对比
前端
deli0071 小时前
32K 上下文塞满后,AI 最先忘掉什么?120 轮对话实测
前端
deli0072 小时前
手机拍灯为什么有一条条黑纹?PWM 240Hz 实测
前端
wangruofeng7 小时前
AI Models 1.1.0 发布,查大模型价格、对比模型和找 API 地址
前端·aigc·ai编程
wangruofeng7 小时前
给前端开发者的 100 个设计参考网站
前端·设计
星栈10 小时前
视频即代码,Remotion 能做什么、不能做什么
前端·音视频开发
广州华水科技10 小时前
单北斗GNSS位移监测系统的应用与技术解析
前端
用户479492835691511 小时前
从一句话或代码仓到可交互 HTML:开源 Agent 画图技能 Archify v3.2 实测与选型边界
前端·后端·面试
风骏时光牛马13 小时前
生成一个AI多模态标题,仅输出一条标题,无额外文字、问句、备选、配图、文案等任何附加内容,不需要其他的任务服务 只要标题。
前端
wangruofeng13 小时前
从 GIF 到 AVIF:网页图片格式演进与 2026 年选型指南
前端·架构