如何在React Hook中使用Debounce/Throttle实现非空搜索输入延时API请求
错误原因说明
你之前的用法存在两个核心问题:
- 你使用的
useDebounce自定义Hook的作用是返回防抖后的变量,不接收函数作为入参,你传入回调函数的用法不符合这个Hook的设计逻辑。 - 所有React Hook必须在组件的顶层调用,不能放在
useEffect内部或者条件判断中,这违反了React Hook的调用规则,会导致不可预期的bug。
另外搜索场景优先推荐使用**防抖(debounce)**而非节流(throttle),防抖的逻辑是用户停止输入指定时长后才触发请求,更符合搜索功能的用户体验。
方案1:使用自定义useDebounce Hook的正确写法
你可以继续使用现有的useDebounce Hook,按以下方式调整组件代码即可:
import { useState, useEffect } from 'react' // 引入你现有的useDebounce Hook import { useDebounce } from './你的hook路径' const SearchComponent = () => { // 输入框原始搜索词 const [query, setQuery] = useState('') // 得到防抖500ms后的搜索词,用户连续输入时该值不会更新 const debouncedQuery = useDebounce(query, 500) // 监听防抖后的搜索词,非空时发起请求 useEffect(() => { if (debouncedQuery.trim()) { // 这里替换为你的API请求逻辑 console.log('发起搜索,参数为:', debouncedQuery) } }, [debouncedQuery]) // 绑定输入框onChange事件 const handleInputChange = (e) => { setQuery(e.target.value) } return <input value={query} onChange={handleInputChange} placeholder="输入搜索内容" /> }
方案2:使用lodash防抖/节流的正确写法
如果你想使用lodash的工具函数,可以按以下方式实现:
import { useState, useEffect, useRef } from 'react' import { debounce } from 'lodash' const SearchComponent = () => { const [query, setQuery] = useState('') // 把防抖函数存到useRef中,避免重渲染生成新实例导致防抖失效 const debouncedSearch = useRef( debounce((searchKey) => { // 这里替换为你的API请求逻辑 console.log('发起搜索,参数为:', searchKey) }, 500) ).current // 监听原始query变化,非空时调用防抖函数 useEffect(() => { if (query.trim()) { debouncedSearch(query) } }, [query, debouncedSearch]) // 组件卸载时清除定时器,避免内存泄漏 useEffect(() => { return () => { debouncedSearch.cancel() } }, [debouncedSearch]) const handleInputChange = (e) => { setQuery(e.target.value) } return <input value={query} onChange={handleInputChange} placeholder="输入搜索内容" /> }
如果你需要使用节流逻辑,只需要把lodash的debounce替换为throttle,配置你需要的参数即可,调用逻辑完全相同。
内容的提问来源于stack exchange,提问作者user3808307
相关产品推荐
相关产品推荐

