DEV Community

Cover image for React Custom Hooks: useDebounce
Bayu Setiawan
Bayu Setiawan

Posted on • Updated on

React Custom Hooks: useDebounce

Have you ever encountered situations where you needed to handle user input in real-time interactions, such as instant search or live content filtering? These scenarios often come with a challenge: managing the frequency of function calls triggered by user input. That's where the useDebounce custom hook comes to the rescue. In this article, we'll explore the concept of debouncing, the importance of the useDebounce hook, and provide you with a hands-on example of its implementation in a React application.

Understanding Debouncing

Debouncing is a technique used to control the frequency of function calls. It's incredibly valuable when dealing with scenarios where frequent updates could cause performance issues or unwanted behaviors. Imagine an instant search feature that sends an API request with every keystroke - without debouncing, you'd flood the server with requests and create a laggy user experience.

Debouncing solves this by introducing a delay between function calls. When the function is called, a timer starts. If the function is called again before the timer completes, the timer is reset. This ensures that the function is only executed when there's a pause in the calls.

Introducing the useDebounce Custom Hook

The useDebounce custom hook is a tool in your React toolkit that simplifies debouncing. It encapsulates the logic required to delay updates and provides you with a debounced value that you can use in your components.

Let's dive into creating our own useDebounce hook.

import { useState, useEffect } from 'react';

const useDebounce = (value, delay) => {
  const [debouncedValue, setDebouncedValue] = useState(value);

  useEffect(() => {
    const timer = setTimeout(() => {
      setDebouncedValue(value);
    }, delay);

    return () => {
      clearTimeout(timer);
    };
  }, [value, delay]);

  return debouncedValue;
};

export default useDebounce;

Enter fullscreen mode Exit fullscreen mode

Implementing the useDebounce Hook

Consider a scenario where we want to create an instant search input. As the user types, we'll use the useDebounce hook to delay the API call until the user pauses typing.

Let's take a look at how this works in practice:

import React, { useState } from 'react';
import useDebounce from './useDebounce'; // Update the path as needed

const InstantSearch = () => {
  const [inputValue, setInputValue] = useState('');
  const debouncedInputValue = useDebounce(inputValue, 300); // Debounce with 300ms delay

  // Simulate an API call with debouncedInputValue
  const fetchSearchResults = async (query) => {
    // Perform API request and update results
  };

  const handleInputChange = (event) => {
    setInputValue(event.target.value);
  };

  // Trigger API call with debounced input value
  useEffect(() => {
    fetchSearchResults(debouncedInputValue);
  }, [debouncedInputValue]);

  return (
    <div>
      <h1>Instant Search with useDebounce</h1>
      <input
        type="text"
        value={inputValue}
        onChange={handleInputChange}
        placeholder="Search..."
      />
      <p>Search results will appear here.</p>
    </div>
  );
};

export default InstantSearch;

Enter fullscreen mode Exit fullscreen mode

Benefits and Use Cases

  1. Improved User Experience: Users won't experience lag due to frequent function calls during real-time interactions.
  2. Reduced Server Load: Fewer unnecessary API calls result in optimized server performance.
  3. Preventing Glitches: Debouncing helps prevent visual glitches caused by rapid updates.

Use cases for useDebounce are abundant: instant search, filtering large datasets, resizing event listeners, and more.

Best Practices

  1. Choosing Delay Time: Experiment with different delay times to find the right balance between responsiveness and server load.
  2. Avoid Overusing: Not every scenario requires debouncing. Use it where frequent updates cause problems.

Conclusion

The useDebounce custom hook is a powerful tool for managing real-time interactions in React applications. By delaying function calls, it enhances user experience and optimizes server performance. Whether you're building an instant search feature or handling other real-time updates, useDebounce is a valuable addition to your React toolbox.

Feel free to experiment with the useDebounce hook in your own projects and watch your real-time interactions become smoother than ever.

Happy coding!

Top comments (2)

Collapse
 
Sloan, the sloth mascot
Comment deleted
Collapse
 
codebayu profile image
Bayu Setiawan

Hi, kindly leave a like and comment if you got new insight! 🔥