К основному содержанию
скилл CX Codex

react-testing-patterns — скилл для Claude Code: как установить

Скилл react-testing-patterns задаёт правила тестирования компонентов и хуков React с помощью Testing Library, MSW и Vitest. Помогает писать надёжные проверки без привязки к деталям реализации.

MIT 141 установок ★ 8 обновлён 2026-02-06

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add hieutrtr/ai1-skills --skill react-testing-patterns -a claude-code
Открыть на GitHub

Что делает react-testing-patterns

Скилл учит агента тестировать поведение компонентов, а не детали их реализации. Приоритет отдан доступным ролям. Агент ищет элементы через getByRole и формы по подписям, оставляя getByTestId на крайний случай. Вместо вызова fireEvent правила строго требуют userEvent, чтобы повторять действия живого пользователя.

Скилл содержит шаблоны для структуры Arrange-Act-Assert, проверки доступности через jest-axe и тестирования асинхронных состояний через findBy*. Для сетевых запросов настроен сервер MSW версии 2 с перезагрузкой хэндлеров между тестами. Хуки тестируются через renderHook и таймеры Vitest.

Для сквозных E2E-тестов скилл не подходит. Автор исключил сценарии с Playwright и контроль TDD, отсылая к скиллам e2e-testing и tdd-workflow.

Какие задачи решает

  • написать компонентные тесты с проверкой доступности через jest-axe
  • протестировать кастомный React-хук с помощью renderHook
  • настроить мокирование API-запросов через MSW
  • проверить асинхронные состояния загрузки и ошибок через findBy

Примеры запросов агенту

  • Напиши тест для компонента карточки пользователя с проверкой доступности
  • Протестируй хук useDebounce с эмуляцией таймеров через Vitest
  • Смоделируй ошибку 404 в MSW и проверь отображение алерта в профиле

Как установить react-testing-patterns

1Через Skills CLI (Vercel)

npx skills add hieutrtr/ai1-skills --skill react-testing-patterns -a claude-code

2Вручную: положить файлы

~/.claude/skills/react-testing-patterns/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/react-testing-patterns/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о react-testing-patterns

Как установить react-testing-patterns в Claude Code?

Выполните команду npx skills add hieutrtr/ai1-skills --skill react-testing-patterns -a claude-code. Файл скилла сохранится в ~/.claude/skills/react-testing-patterns/SKILL.md.

Какие библиотеки поддерживаются в react-testing-patterns?

Скилл рассчитан на стек из React 18+, Testing Library 14+, MSW 2+, Vitest или Jest, а также jest-axe.

Подходит ли этот скилл для сквозного E2E-тестирования?

Нет, E2E-тесты в браузере через Playwright исключены из правил. Для браузерных проверок автор рекомендует скилл e2e-testing.

Исходный текст

SKILL.md · MIT
---
name: react-testing-patterns
description: >-
  React component and hook testing patterns with Testing Library and Vitest. Use when
  writing tests for React components, custom hooks, or data fetching logic. Covers
  component rendering tests, user interaction simulation, async state testing, MSW for
  API mocking, hook testing with renderHook, accessibility assertions, and snapshot
  testing guidelines. Does NOT cover E2E tests (use e2e-testing) or TDD workflow
  enforcement (use tdd-workflow).
license: MIT
compatibility: 'React 18+, Testing Library 14+, MSW 2+, jest-axe, Vitest/Jest'
metadata:
  author: platform-team
  version: '1.0.0'
  sdlc-phase: testing
allowed-tools: Read Edit Write Bash(npm:*) Bash(npx:*)
context: fork
---

# React Testing Patterns

## When to Use

Activate this skill when:
- Writing tests for React components (rendering, interaction, accessibility)
- Testing custom hooks with `renderHook`
- Mocking API calls with MSW (Mock Service Worker)
- Testing async state changes (loading, error, success)
- Auditing component accessibility with jest-axe
- Setting up test infrastructure (providers, test utilities)

Do NOT use this skill for:
- E2E browser tests with Playwright (use `e2e-testing`)
- Backend Python tests (use `pytest-patterns`)
- TDD workflow enforcement (use `tdd-workflow`)
- Writing component implementation code (use `react-frontend-expert`)

## Instructions

### Testing Library Philosophy

**Core principle:** Test behavior, not implementation.

**Query priority** (prefer higher in the list):
1. `getByRole` — accessible role (button, heading, textbox)
2. `getByLabelText` — form elements with labels
3. `getByPlaceholderText` — input placeholders
4. `getByText` — visible text content
5. `getByDisplayValue` — current form input value
6. `getByAltText` — images
7. `getByTestId` — last resort (data-testid attribute)

**Interaction:** Always use `userEvent` over `fireEvent`:
```tsx
import userEvent from "@testing-library/user-event";

// Good — simulates real user behavior
const user = userEvent.setup();
await user.click(button);
await user.type(input, "hello");

// Bad — low-level event dispatch
fireEvent.click(button);
```

**What NOT to test:**
- Internal component state (don't test `useState` values directly)
- CSS classes or styles
- Component instance methods
- Which hooks were called
- Snapshot tests for dynamic content
- Third-party library internals

### Component Test Structure

Every component test follows Arrange → Act → Assert:

```tsx
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { axe } from "jest-axe";
import { UserCard } from "./UserCard";

describe("UserCard", () => {
  const defaultProps = {
    user: { id: 1, displayName: "Alice", email: "[email protected]" },
    onEdit: vi.fn(),
  };

  it("renders user name", () => {
    // Arrange
    render(<UserCard {...defaultProps} />);
    // Assert
    expect(screen.getByText("Alice")).toBeInTheDocument();
  });

  it("calls onEdit when edit button is clicked", async () => {
    // Arrange
    const user = userEvent.setup();
    render(<UserCard {...defaultProps} />);
    // Act
    await user.click(screen.getByRole("button", { name: /edit/i }));
    // Assert
    expect(defaultProps.onEdit).toHaveBeenCalledWith(1);
  });

  it("has no accessibility violations", async () => {
    const { container } = render(<UserCard {...defaultProps} />);
    expect(await axe(container)).toHaveNoViolations();
  });
});
```

### Async Testing

#### waitFor (wait for state update)

```tsx
it("shows user data after loading", async () => {
  render(<UserProfile userId={1} />);

  // Loading state
  expect(screen.getByText(/loading/i)).toBeInTheDocument();

  // Wait for data to appear
  await waitFor(() => {
    expect(screen.getByText("Alice")).toBeInTheDocument();
  });

  // Loading state gone
  expect(screen.queryByText(/loading/i)).not.toBeInTheDocument();
});
```

#### findBy (built-in waitFor)

```tsx
it("shows user data after loading", async () => {
  render(<UserProfile userId={1} />);

  // findBy = getBy + waitFor — preferred for async appearance
  const heading = await screen.findByRole("heading", { name: "Alice" });
  expect(heading).toBeInTheDocument();
});
```

**Prefer `findBy*` over `waitFor` + `getBy*`** for elements that appear asynchronously.

#### Testing Error States

```tsx
it("shows error message on API failure", async () => {
  // Override MSW handler for this test
  server.use(
    http.get("/api/users/:id", () => {
      return HttpResponse.json(
        { detail: "User not found" },
        { status: 404 },
      );
    }),
  );

  render(<UserProfile userId={999} />);

  const error = await screen.findByRole("alert");
  expect(error).toHaveTextContent(/not found/i);
});
```

### MSW API Mocking

Setup a mock server for all API tests:

```tsx
// test/mocks/handlers.ts
import { http, HttpResponse } from "msw";

export const handlers = [
  http.get("/api/users", () => {
    return HttpResponse.json({
      items: [
        { id: 1, displayName: "Alice", email: "[email protected]" },
        { id: 2, displayName: "Bob", email: "[email protected]" },
      ],
      next_cursor: null,
      has_more: false,
    });
  }),

  http.get("/api/users/:id", ({ params }) => {
    return HttpResponse.json({
      id: Number(params.id),
      displayName: "Alice",
      email: "[email protected]",
    });
  }),

  http.post("/api/users", async ({ request }) => {
    const body = await request.json();
    return HttpResponse.json(
      { id: 3, ...body, created_at: new Date().toISOString() },
      { status: 201 },
    );
  }),
];
```

```tsx
// test/mocks/server.ts
import { setupServer } from "msw/node";
import { handlers } from "./handlers";

export const server = setupServer(...handlers);
```

```tsx
// test/setup.ts (Vitest setup file)
import { server } from "./mocks/server";

beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
afterEach(() => server.resetHandlers());
afterAll(() => server.close());
```

**Per-test handler override:**
```tsx
server.use(
  http.get("/api/users", () => {
    return HttpResponse.json({ items: [], next_cursor: null, has_more: false });
  }),
);
```

### Hook Testing

```tsx
import { renderHook, act } from "@testing-library/react";
import { useDebounce } from "./useDebounce";

describe("useDebounce", () => {
  beforeEach(() => { vi.useFakeTimers(); });
  afterEach(() => { vi.useRealTimers(); });

  it("returns initial value immediately", () => {
    const { result } = renderHook(() => useDebounce("hello", 300));
    expect(result.current).toBe("hello");
  });

  it("debounces value changes", () => {
    const { result, rerender } = renderHook(
      ({ value }) => useDebounce(value, 300),
      { initialProps: { value: "hello" } },
    );

    rerender({ value: "world" });
    expect(result.current).toBe("hello"); // Still old value

    act(() => { vi.advanceTimersByTime(300); });
    expect(result.current).toBe("world"); // Now updated
  });
});
```

**Testing hooks with TanStack Query:**
```tsx
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";

function createWrapper() {
  const queryClient = new QueryClient({
    defaultOptions: { queries: { retry: false } },
  });
  return ({ children }) => (
    <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
  );
}

it("fetches users", async () => {
  const { result } = renderHook(() => useUsers(), { wrapper: createWrapper() });
  await waitFor(() => expect(result.current.isSuccess).toBe(true));
  expect(result.current.data).toHaveLength(2);
});
```

### Accessibility Testing

Add to every component test file:

```tsx
import { axe, toHaveNoViolations } from "jest-axe";

expect.extend(toHaveNoViolations);

it("has no accessibility violations", async () => {
  const { container } = render(<UserCard {...defaultProps} />);
  const results = await axe(container);
  expect(results).toHaveNoViolations();
});
```

### Test Utility: Custom Render

Create a custom render that wraps components with required providers:

```tsx
// test/utils.tsx
import { render, RenderOptions } from "@testing-library/react";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { MemoryRouter } from "react-router-dom";
import { AuthProvider } from "@/contexts/AuthContext";

function AllProviders({ children }: { children: React.ReactNode }) {
  const queryClient = new QueryClient({
    defaultOptions: { queries: { retry: false, gcTime: 0 } },
  });
  return (
    <QueryClientProvider client={queryClient}>
      <MemoryRouter>
        <AuthProvider>{children}</AuthProvider>
      </MemoryRouter>
    </QueryClientProvider>
  );
}

export function renderWithProviders(ui: React.ReactElement, options?: RenderOptions) {
  return render(ui, { wrapper: AllProviders, ...options });
}
```

## Examples

### Testing a Form Component

```tsx
describe("CreateUserForm", () => {
  it("submits valid data", async () => {
    const onSubmit = vi.fn();
    const user = userEvent.setup();
    render(<CreateUserForm onSubmit={onSubmit} />);

    await user.type(screen.getByLabelText(/email/i), "[email protected]");
    await user.type(screen.getByLabelText(/name/i), "Test User");
    await user.click(screen.getByRole("button", { name: /create/i }));

    expect(onSubmit).toHaveBeenCalledWith({
      email: "[email protected]",
      displayName: "Test User",
      role: "member",
    });
  });

  it("shows validation errors for empty required fields", async () => {
    const user = userEvent.setup();
    render(<CreateUserForm onSubmit={vi.fn()} />);
    await user.click(screen.getByRole("button", { name: /create/i }));

    expect(await screen.findByText(/required/i)).toBeInTheDocument();
  });
});
```

## Edge Cases

- **Components with providers:** Always use a custom render function that wraps components with `QueryClientProvider`, `MemoryRouter`, and any context providers needed.

- **Components with router:** Use `<MemoryRouter initialEntries={["/users/1"]}>` for components that use `useParams` or `useNavigate`.

- **Flaky async tests:** Prefer `findBy*` over `waitFor` + `getBy*`. If using `waitFor`, increase timeout for CI: `waitFor(() => ..., { timeout: 5000 })`.

- **Testing modals/portals:** Use `screen` queries (they search the entire document), not `container` queries.

- **Cleanup:** Testing Library auto-cleans after each test. Don't call `cleanup()` manually unless using a custom setup.

See `references/component-test-template.tsx` for an annotated test file template.
See `references/msw-handler-examples.ts` for MSW handler patterns.
See `references/hook-test-template.tsx` for hook testing patterns.

© platform-team · MIT · hieutrtr/ai1-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
react-testing affaan-m Скилл для написания тестов React-компонентов, хуков и страниц: React Testing Library, Vitest или Jest, MSW для моков сети и проверки доступности через axe. CX Codex +1 6 700установок javascript-testing-patterns Seth Hobson Скилл javascript-testing-patterns подсказывает, как писать unit-, интеграционные и end-to-end-тесты для JavaScript и TypeScript. Пригодится при настройке тестовой инфраструктуры и работе по TDD. CX Codex +1 20 472установок frontend-testing-best-practices sergiodxa Скилл frontend-testing-best-practices для Claude Code задаёт 6 правил тестирования фронтенда: вместо изолированных юнит-тестов компонентов — сквозные E2E-тесты в Playwright. CX Codex +1 2 300установок react-testing-library pproenca Скилл react-testing-library для Claude Code, Cursor, Codex и других агентов с 43 правилами тестирования React-компонентов через Testing Library. Включается на тестовых файлах, запросах getBy/queryBy, userEvent и waitFor. CX Codex +1 428установок vitest-testing-patterns curiositech Скилл vitest-testing-patterns задаёт шаблоны для написания тестов на Vitest и React Testing Library. Помогает генерировать проверки компонентов, роутов и мокировать внешние сервисы. CX Codex +1 373установок react-native-testing callstack Скилл react-native-testing для написания и проверки тестов компонентов React Native с помощью Testing Library. Покрывает запросы, взаимодействия, асинхронные паттерны и работает с версиями v13 (React 18) и v14 (React 19+). CX Codex +1 5 600установок

Из того же набора8

e2e-testing Скилл e2e-testing задаёт шаблоны E2E-тестирования на Playwright для веб-приложений на React и Python. Помогает строить надёжные сквозные сценарии и Page Objects. CX Codex +1 1 600установок code-review-security Скилл code-review-security для Claude Code проверяет изменения кода на уязвимости и секреты. Запускается при ревью pull request, проверке авторизации и обработке пользовательского ввода. CX Codex +1 446установок react-frontend-expert Скилл react-frontend-expert задаёт правила вёрстки React-компонентов на TypeScript, создания кастомных хуков и работы с TanStack Query. CX Codex +1 208установок python-backend-expert Скилл python-backend-expert задаёт паттерны бэкенда на FastAPI, SQLAlchemy 2.0 и Pydantic v2. Помогает писать асинхронные эндпоинты, репозитории и миграции Alembic. CX Codex +1 138установок system-architecture Скилл system-architecture помогает выбрать слои и границы модулей в связке FastAPI и React, а результат складывает в architecture.md и ADR. CX Codex +1 125установок ui-design-system Скилл ui-design-system задаёт единые правила для UI в React/TypeScript: токены, отступы, типографику и доступность. Нужен при создании и ревью компонентов. CX Codex +1 124установок pytest-patterns Скилл pytest-patterns для Claude Code помогает писать тесты Python-бэкенда на pytest. Он включается при работе с сервисами, репозиториями и API FastAPI. CX Codex +1 123установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой