javascript 60 lines · 9 steps

Debounced search with cancellation in React

A custom hook delays input updates while AbortController cancels stale fetches, keeping search snappy and consistent.

Explained by highlit
React Intermediate custom-hooks debounce abortcontroller effect-cleanup data-fetching
1import { useState, useEffect, useMemo } from 'react';
2 
3function useDebounce(value, delay = 300) {
4 const [debounced, setDebounced] = useState(value);
5 
6 useEffect(() => {
7 const timer = setTimeout(() => setDebounced(value), delay);
8 return () => clearTimeout(timer);
9 }, [value, delay]);
10 
11 return debounced;
12}
13 
14export function SearchBox({ onResults }) {
15 const [query, setQuery] = useState('');
16 const debouncedQuery = useDebounce(query, 400);
17 const [results, setResults] = useState([]);
18 const [loading, setLoading] = useState(false);
19 
20 useEffect(() => {
21 const term = debouncedQuery.trim();
22 if (!term) {
23 setResults([]);
24 return;
25 }
26 
27 const controller = new AbortController();
28 setLoading(true);
29 
30 fetch(`/api/search?q=${encodeURIComponent(term)}`, { signal: controller.signal })
31 .then((res) => res.json())
32 .then((data) => {
33 setResults(data.items);
34 onResults?.(data.items);
35 })
36 .catch((err) => {
37 if (err.name !== 'AbortError') console.error(err);
38 })
39 .finally(() => setLoading(false));
40 
41 return () => controller.abort();
42 }, [debouncedQuery, onResults]);
43 
44 return (
45 <div className="search-box">
46 <input
47 type="search"
48 value={query}
49 placeholder="Search products…"
50 onChange={(e) => setQuery(e.target.value)}
51 />
52 {loading && <span className="spinner" aria-hidden />}
53 <ul>
54 {results.map((item) => (
55 <li key={item.id}>{item.name}</li>
56 ))}
57 </ul>
58 </div>
59 );
60}
01 / 01
STEP 01

Walkthrough

Space play ←→ step click any line
Three takeaways
  1. 1Debouncing input prevents firing a request on every keystroke, cutting wasted network calls.
  2. 2Returning a cleanup function from useEffect cancels in-flight work before the next effect runs.
  3. 3AbortController plus an AbortError check avoids race conditions and noise from cancelled requests.

Related explainers

javascript 
'use server'
 
import { revalidatePath } from 'next/cache'
import { redirect } from 'next/navigation'

How a Next.js Server Action updates a post

server-actions authorization validation
Intermediate 7 steps
javascript 
const express = require('express');
 
const v1 = express.Router();
 

Versioning an API with Express Routers

api versioning routing modularity
Intermediate 10 steps
javascript 
const RATE_LIMIT = 100;
const WINDOW_MS = 60 * 1000;
const BLOCK_MS = 5 * 60 * 1000;
 

Building a rate-limiting middleware in Express

rate-limiting middleware closures
Intermediate 9 steps
javascript 
const transitions = {
  cart: { checkout: 'shipping' },
  shipping: { submitAddress: 'payment', back: 'cart' },
  payment: { submitPayment: 'review', back: 'shipping' },

A finite state machine for checkout flow

state-machine event-driven data-driven-design
Intermediate 7 steps
typescript 
import { Component } from '@angular/core';
import { FormControl, ReactiveFormsModule } from '@angular/forms';
import { HttpClient } from '@angular/common/http';
import { AsyncPipe } from '@angular/common';

Reactive type-ahead search in Angular

rxjs reactive-forms debounce
Intermediate 9 steps
javascript 
import { useState, useEffect, useCallback, useRef } from "react";
 
export function usePersistentForm(storageKey, initialValues) {
  const [values, setValues] = useState(() => {

A React hook that persists form state to localStorage

custom-hooks localstorage debounce
Intermediate 9 steps

Share this explainer

Here's the card — post it anywhere.

Debounced search with cancellation in React — share card
Made with highlit — turn any snippet into a walkthrough like this in about a minute.
Explain your code