TDD в экосистеме React: разработка UI через тесты

+-----------------------------------------------------------------------+
|                      USER-CENTRIC REACT TDD CYCLE                     |
+-----------------------------------------------------------------------+
|                                                                       |
|   1. Спецификация через пользовательский контракт (RED)               |
|      [userEvent.type(input, 'TypeScript')]                            |
|                       │                                               |
|                       ▼                                               |
|   2. Диспетчеризация событий браузера                                 |
|      (focusin -> keydown -> input -> change -> keyup)                 |
|                       │                                               |
|                       ▼                                               |
|   3. React 19 Concurrent Scheduler                                    |
|      (Fiber Work Loop -> State Transition -> Microtasks Flush)        |
|                       │                                               |
|                       ▼                                               |
|   4. Мутация DOM и дерева доступности (GREEN)                         |
|      [<div role="listbox"> -> <li role="option">TypeScript</li>]      |
|                       │                                               |
|                       ▼                                               |
|   5. Верификация контракта ARIA                                       |
|      expect(screen.getByRole('option', { name: 'TypeScript' }))       |
|                                                                       |
+-----------------------------------------------------------------------+

import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
import { renderHook, act } from '@testing-library/react';
import { useDebouncedSearch } from './use-debounced-search';

describe('useDebouncedSearch', () => {
  beforeEach(() => {
    vi.useFakeTimers();
  });

  afterEach(() => {
    vi.useRealTimers();
  });

  it('должен возвращать исходное значение сразу при первой инициализации', () => {
    const { result } = renderHook(() => useDebouncedSearch('react', 300));
    expect(result.current).toBe('react');
  });

  it('должен обновлять значение только по истечении указанной задержки', () => {
    const { result, rerender } = renderHook(
      ({ value }) => useDebouncedSearch(value, 300),
      { initialProps: { value: 'react' } }
    );

    // Меняем входящее значение
    rerender({ value: 'react 19' });

    // До истечения таймера значение остается старым
    expect(result.current).toBe('react');

    // Проматываем время вперед на 299 мс
    act(() => {
      vi.advanceTimersByTime(299);
    });
    expect(result.current).toBe('react');

    // Проматываем оставшуюся 1 мс
    act(() => {
      vi.advanceTimersByTime(1);
    });
    expect(result.current).toBe('react 19');
  });

  it('должен сбрасывать предыдущий таймер при быстром последовательном вводе', () => {
    const { result, rerender } = renderHook(
      ({ value }) => useDebouncedSearch(value, 300),
      { initialProps: { value: 'a' } }
    );

    rerender({ value: 'ab' });
    act(() => {
      vi.advanceTimersByTime(200);
    });

    rerender({ value: 'abc' });
    act(() => {
      vi.advanceTimersByTime(200);
    });

    // Прошло 400 мс суммарно, но между вторым и третьим вводом прошло лишь 200 мс
    expect(result.current).toBe('a');

    act(() => {
      vi.advanceTimersByTime(100);
    });
    expect(result.current).toBe('abc');
  });
});

import { useState, useEffect } from 'react';

export function useDebouncedSearch<T>(value: T, delayMs: number): T {
  const [debouncedValue, setDebouncedValue] = useState<T>(value);

  useEffect(() => {
    const timerId = setTimeout(() => {
      setDebouncedValue(value);
    }, delayMs);

    return () => {
      clearTimeout(timerId);
    };
  }, [value, delayMs]);

  return debouncedValue;
}

import { describe, it, expect, vi } from 'vitest';
import { render, screen } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import React from 'react';
import { TagFilterSearch } from './tag-filter-search';

describe('TagFilterSearch', () => {
  const availableTags = ['Architecture', 'Vitest', 'React 19', 'Performance', 'TypeScript'];

  it('должен отображать поле ввода и показывать отфильтрованные подсказки при вводе', async () => {
    const user = userEvent.setup();
    const handleTagsChange = vi.fn();

    render(
      <TagFilterSearch
        tags={availableTags}
        selectedTags={[]}
        onChange={handleTagsChange}
      />
    );

    const input = screen.getByRole('combobox', { name: /поиск тегов/i });
    expect(input).toBeInTheDocument();

    // Вводим поисковый запрос
    await user.type(input, 'Type');

    // Ожидаем появления списка доступных вариантов
    const option = await screen.findByRole('option', { name: 'TypeScript' });
    expect(option).toBeInTheDocument();

    // Вариант, не подходящий под фильтр, не должен присутствовать
    expect(screen.queryByRole('option', { name: 'Architecture' })).toBeNull();
  });
});

'use client';

import React, { useState, useId, useMemo } from 'react';

export interface TagFilterSearchProps {
  readonly tags: readonly string[];
  readonly selectedTags: readonly string[];
  readonly onChange: (nextTags: readonly string[]) => void;
}

export function TagFilterSearch({
  tags,
  selectedTags,
  onChange,
}: TagFilterSearchProps): React.JSX.Element {
  const [query, setQuery] = useState('');
  const inputId = useId();
  const listboxId = useId();

  const selectedSet = useMemo(() => new Set(selectedTags), [selectedTags]);

  const filteredTags = useMemo(() => {
    if (!query.trim()) return [];
    return tags
      .filter((tag) => !selectedSet.has(tag))
      .filter((tag) => tag.toLowerCase().includes(query.toLowerCase()));
  }, [tags, query, selectedSet]);

  const hasSuggestions = filteredTags.length > 0;

  return (
    <div className="tag-filter-container">
      <label htmlFor={inputId}>Поиск тегов</label>
      <input
        id={inputId}
        role="combobox"
        aria-expanded={hasSuggestions}
        aria-controls={hasSuggestions ? listboxId : undefined}
        aria-autocomplete="list"
        type="text"
        value={query}
        onChange={(e) => setQuery(e.target.value)}
      />

      {hasSuggestions && (
        <ul id={listboxId} role="listbox" aria-label="Найденные теги">
          {filteredTags.map((tag) => (
            <li
              key={tag}
              role="option"
              aria-selected={false}
              onClick={() => {
                onChange([...selectedTags, tag]);
                setQuery('');
              }}
            >
              {tag}
            </li>
          ))}
        </ul>
      )}
    </div>
  );
}

it('должен добавлять тег при клике на опцию и очищать поле ввода', async () => {
  const user = userEvent.setup();
  const handleTagsChange = vi.fn();

  const { rerender } = render(
    <TagFilterSearch
      tags={availableTags}
      selectedTags={[]}
      onChange={handleTagsChange}
    />
  );

  const input = screen.getByRole('combobox', { name: /поиск тегов/i });
  await user.type(input, 'React');

  const option = screen.getByRole('option', { name: 'React 19' });
  await user.click(option);

  // Проверяем вызов коллбэка
  expect(handleTagsChange).toHaveBeenCalledTimes(1);
  expect(handleTagsChange).toHaveBeenCalledWith(['React 19']);

  // Симулируем обновление родительского состояния
  rerender(
    <TagFilterSearch
      tags={availableTags}
      selectedTags={['React 19']}
      onChange={handleTagsChange}
    />
  );

  // Инпут очистился, меню скрылось
  expect(input).toHaveValue('');
  expect(screen.queryByRole('listbox')).toBeNull();

  // Появился бейдж выбранного тега
  const removeButton = screen.getByRole('button', { name: /удалить тег react 19/i });
  expect(removeButton).toBeInTheDocument();
});

it('должен вызывать onChange с удалением тега при клике на бейдж', async () => {
  const user = userEvent.setup();
  const handleTagsChange = vi.fn();

  render(
    <TagFilterSearch
      tags={availableTags}
      selectedTags={['Architecture', 'Vitest']}
      onChange={handleTagsChange}
    />
  );

  const removeArchButton = screen.getByRole('button', { name: /удалить тег architecture/i });
  await user.click(removeArchButton);

  expect(handleTagsChange).toHaveBeenCalledTimes(1);
  expect(handleTagsChange).toHaveBeenCalledWith(['Vitest']);
});

'use client';

import React, { useState, useId, useMemo, useCallback } from 'react';

export interface TagFilterSearchProps {
  readonly tags: readonly string[];
  readonly selectedTags: readonly string[];
  readonly onChange: (nextTags: readonly string[]) => void;
}

export function TagFilterSearch({
  tags,
  selectedTags,
  onChange,
}: TagFilterSearchProps): React.JSX.Element {
  const [query, setQuery] = useState('');
  const inputId = useId();
  const listboxId = useId();

  const selectedSet = useMemo(() => new Set(selectedTags), [selectedTags]);

  const filteredTags = useMemo(() => {
    const trimmed = query.trim().toLowerCase();
    if (!trimmed) return [];
    return tags
      .filter((tag) => !selectedSet.has(tag))
      .filter((tag) => tag.toLowerCase().includes(trimmed));
  }, [tags, query, selectedSet]);

  const handleSelect = useCallback(
    (tag: string) => {
      onChange([...selectedTags, tag]);
      setQuery('');
    },
    [selectedTags, onChange]
  );

  const handleRemove = useCallback(
    (tagToRemove: string) => {
      onChange(selectedTags.filter((t) => t !== tagToRemove));
    },
    [selectedTags, onChange]
  );

  const hasSuggestions = filteredTags.length > 0;

  return (
    <div className="tag-filter-search">
      {/* Список уже выбранных тегов */}
      {selectedTags.length > 0 && (
        <ul className="selected-tags-list" aria-label="Выбранные теги">
          {selectedTags.map((tag) => (
            <li key={tag} className="selected-tag-item">
              <span>{tag}</span>
              <button
                type="button"
                aria-label={`Удалить тег ${tag}`}
                onClick={() => handleRemove(tag)}
              >
                ×
              </button>
            </li>
          ))}
        </ul>
      )}

      {/* Поле поиска */}
      <div className="input-wrapper">
        <label htmlFor={inputId}>Поиск тегов</label>
        <input
          id={inputId}
          role="combobox"
          aria-expanded={hasSuggestions}
          aria-controls={hasSuggestions ? listboxId : undefined}
          aria-autocomplete="list"
          type="text"
          value={query}
          onChange={(e) => setQuery(e.target.value)}
        />
      </div>

      {/* Выпадающий список совпадений */}
      {hasSuggestions && (
        <ul id={listboxId} role="listbox" aria-label="Найденные теги">
          {filteredTags.map((tag) => (
            <li
              key={tag}
              role="option"
              aria-selected={false}
              tabIndex={0}
              onClick={() => handleSelect(tag)}
              onKeyDown={(e) => {
                if (e.key === 'Enter') {
                  e.preventDefault();
                  handleSelect(tag);
                }
              }}
            >
              {tag}
            </li>
          ))}
        </ul>
      )}
    </div>
  );
}