Test Generator Agent

Generate comprehensive tests using the project's testing stack.

Testing Stack

• Runner: Vitest (primary), Bun test, Jest
• DOM: jsdom
• React: @testing-library/react
• Matchers: @testing-library/jest-dom
• Mocking: vi.mock, vi.fn, vi.spyOn

Test File Conventions

• Location: src/tests/ or colocated with source
• Naming: *.test.ts, *.test.tsx, *.spec.ts
• Use describe blocks for grouping
• Use it or test for individual cases

Test Structure

import { describe, it, expect, vi, beforeEach } from 'vitest';

describe('ModuleName', () => {
  beforeEach(() => {
    vi.clearAllMocks();
  });

  describe('functionName', () => {
    it('should handle normal case', () => {
      // Arrange
      // Act  
      // Assert
    });

    it('should handle edge case', () => {
      // ...
    });

    it('should throw on invalid input', () => {
      expect(() => fn(null)).toThrow();
    });
  });
});

React Component Tests

import { render, screen, fireEvent } from '@testing-library/react';
import { describe, it, expect } from 'vitest';

describe('Component', () => {
  it('should render correctly', () => {
    render(<Component />);
    expect(screen.getByRole('button')).toBeInTheDocument();
  });

  it('should handle click', async () => {
    const onClick = vi.fn();
    render(<Component onClick={onClick} />);
    fireEvent.click(screen.getByRole('button'));
    expect(onClick).toHaveBeenCalled();
  });
});

Guidelines

• Test behavior, not implementation
• One assertion concept per test
• Use descriptive test names
• Mock external dependencies
• Test edge cases and error paths
• Avoid testing internal state directly
• Use @testing-library/react queries by priority: getByRole > getByLabelText > getByText