Продвинутый useEffect — поиск в реальном времени

В этой главе вы углубитесь в механизм изменения зависимостей useEffect, чтобы реализовать фильтрацию в реальном времени и оптимизацию debounce для поискового поля.


Триггер изменения зависимости useEffect

Когда значение в массиве зависимостей useEffect изменяется, React повторно запускает эффект.

Пример

import { useState, useEffect } from 'react'

function SearchDemo() {
  const [keyword, setKeyword] = useState('')
  const [results, setResults] = useState([])

  // Всякий раз, когда keyword изменяется, повторно запускать фильтрацию
  useEffect(() => {
    console.log('keyword изменён на:', keyword)
    // Здесь можно выполнить логику поиска
    setResults(/* Отфильтрованные результаты */)
  }, [keyword])  // Зависит от keyword

  return (
    <div>
      <input
        value={keyword}
        onChange={e => setKeyword(e.target.value)}
        placeholder="Поиск..."
      />
      <p>Текущий поиск:{keyword}</p>
    </div>
  )
}

Этот паттерн подходит для отслеживания состояния и автоматического выполнения соответствующей операции при его изменении.


Обработка в событиях vs useEffect

Есть два способа реализовать фильтрацию поиска:

МетодПодходСценарий применения
Функция-обработчик событияФильтрация непосредственно в onChangeПростая логика, срабатывает только в одном месте
Реакция useEffectuseEffect зависит от keywordНесколько источников данных могут влиять на результат фильтрации

В сценарии блога логика фильтрации для ввода в поле поиска очень проста,Её более уместно поместить непосредственно в обработчик события или useMemo.。

useEffect больше подходит для сценариев, требующих синхронизации с внешними системами (например, вызовы API, сохранение в localStorage).


Оптимизация с помощью debounce

Если каждое нажатие клавиши вызывает поиск (локальная фильтрация — это нормально, но если это связано с отправкой сетевых запросов), это приведёт к множеству лишних операций.

ДебаунсИдея: операция выполняется после того, как пользователь перестанет вводить текст на некоторое время.

Пример

import { useState, useEffect } from 'react'

function useDebounce(value, delay = 300) {
  const [debouncedValue, setDebouncedValue] = useState(value)

  useEffect(() => {
    // Установить таймер: обновить debouncedValue через delay ms
    const timer = setTimeout(() => {
      setDebouncedValue(value)
    }, delay)

    // Функция очистки: если value снова изменится в течение delay, очистить предыдущий таймер
    return () => clearTimeout(timer)
  }, [value, delay])

  return debouncedValue
}

// Использовать дебаунс
function SearchInput() {
  const [keyword, setKeyword] = useState('')
  const debouncedKeyword = useDebounce(keyword, 300)

  // Выполнять только при изменении debounced-значения (например, отправить запрос)
  useEffect(() => {
    if (debouncedKeyword) {
      console.log('Фактически выполняем поиск:', debouncedKeyword)
      // fetch(`/api/search?q=${debouncedKeyword}`)
    }
  }, [debouncedKeyword])

  return (
    <input
      value={keyword}
      onChange={e => setKeyword(e.target.value)}
      placeholder="Поиск..."
    />
  )
}

Принцип debounce: каждый ввод сбрасывает таймер на 300ms. Только когда в течение 300ms не поступает новый ввод, таймер срабатывает и обновляется debouncedKeyword. Так поиск не будет запускаться слишком часто, когда пользователь быстро печатает.


Практика: добавьте поиск в реальном времени в блог

Пример

// Путь к файлу: src/pages/HomePage.jsx
import { useState, useEffect, useMemo } from 'react'
import BlogCard from '../components/BlogCard'
import CategoryFilter from '../components/CategoryFilter'

function HomePage() {
  const [articles, setArticles] = useState([])
  const [isLoading, setIsLoading] = useState(true)
  const [error, setError] = useState(null)
  const [activeCategory, setActiveCategory] = useState('Все')
  const [keyword, setKeyword] = useState('')   // Ключевое слово поиска

  // Загрузить данные
  useEffect(() => {
    let cancelled = false
    async function fetchPosts() {
      setIsLoading(true)
      try {
        const res = await fetch('/posts.json')
        const data = await res.json()
        if (!cancelled) setArticles(data)
      } catch (err) {
        if (!cancelled) setError(err.message)
      } finally {
        if (!cancelled) setIsLoading(false)
      }
    }
    fetchPosts()
    return () => { cancelled = true }
  }, [])

  const categories = useMemo(() => {
    return ['Все', ...new Set(articles.map(a => a.category))]
  }, [articles])

  // Фильтрация + поиск: фильтровать и по категории, и по ключевому слову
  const filteredArticles = useMemo(() => {
    let result = articles

    // Сначала фильтрация по категории
    if (activeCategory !== 'All') {
      result = result.filter(a => a.category === activeCategory)
    }

    // Затем фильтрация по ключевому слову
    if (keyword.trim()) {
      const kw = keyword.trim().toLowerCase()
      result = result.filter(a =>
        a.title.toLowerCase().includes(kw) ||
        a.summary.toLowerCase().includes(kw)
      )
    }

    return result
  }, [articles, activeCategory, keyword])

  return (
    <div>
      <h2 className="section-title">Последние статьи</h2>

      {/* Поле поиска */}
      <div className="search-bar">
        <input
          type="text"
          value={keyword}
          onChange={e => setKeyword(e.target.value)}
          placeholder="Поиск по заголовкам или аннотациям статей..."
          className="search-input"
        />
        {keyword && (
          <span className="clear-btn" onClick={() => setKeyword('')}>✕</span>
        )}
      </div>

      {isLoading && <p className="status-msg">Загрузка...</p>}

      {error && (
        <div className="status-msg error">
          <p>Не удалось загрузить:{error}</p>
          <button onClick={() => window.location.reload()}>Повторить</button>
        </div>
      )}

      {!isLoading && !error && (
        <>
          <CategoryFilter
            categories={categories}
            activeCategory={activeCategory}
            onCategoryChange={setActiveCategory}
          />
          <p className="result-info">
common{filteredArticles.length}article
            {keyword &&`, поиск по запросу "${keyword}」`}
          </p>
          {filteredArticles.length === 0 ? (
            <p className="empty-tip">Не найдено подходящих статей</p>
          ) : (
            <div className="article-grid">
              {filteredArticles.map(article => (
                <BlogCard key={article.id} {...article} />
              ))}
            </div>
          )}
        </>
      )}
    </div>
  )
}

export default HomePage

Пример

/* Стили поля поиска (добавить в App.css) */
.search-bar {
  position: relative;
  margin-bottom: 20px;
}

.search-input {
  width: 100%;
  padding: 12px 40px 12px 16px;
  border: 2px solid #eee;
  border-radius: 8px;
  font-size: 15px;
  outline: none;
  transition: border-color 0.2s;
}

.search-input:focus {
  border-color: #1976d2;
}

.clear-btn {
  position: absolute;
  right: 12px;
  top: 50%;
  transform: translateY(-50%);
  cursor: pointer;
  color: #999;
  font-size: 18px;
}

.status-msg {
  text-align: center;
  padding: 60px 0;
  font-size: 16px;
  color: #999;
}

.status-msg.error {
  color: #e74c3c;
}

.status-msg.error button {
  margin-left: 10px;
  padding: 4px 12px;
  cursor: pointer;
}

Поиск и фильтрация по категориям могут работать одновременно — после ввода ключевого слова нажатие кнопки категории применяет оба условия для фильтрации.


Краткое содержание главы

В этой главе вы углубились в механизм изменения зависимостей useEffect: эффект повторно выполняется, когда значения в массиве зависимостей изменяются, принцип и реализация debounce (setTimeout + очистка), а также граница выбора между useEffect и обработчиками событий.

Фильтрация в реальном времени в поисковом поле работает плавно — в этом ценность декларативного программирования: вы объявляете правило вычисления для filteredArticles, и React автоматически пересчитывает его, когда его зависимости изменяются.

Другие расширения