Padrões de Migração de Testes do React 19

Referência para todas as migrações de arquivos de teste exigidas pelo React 19.

Ordem de Prioridade

Corrija os arquivos de teste nesta ordem; cada camada depende da anterior:

1. act import corrija primeiro, isso desbloqueia todo o resto
2. Simulate → fireEvent corrija imediatamente após o act
3. Limpeza completa do react-dom/test-utils remova as importações restantes
4. Contagens de chamadas do StrictMode meça o real, não adivinhe
5. Envolvimento assíncrono do act para os avisos restantes de "não envolvido em act"
6. Helper de renderização personalizado verifique uma vez por base de código, não por teste

1. Correção de Importação do act()

// Before  REMOVED in React 19:
import { act } from 'react-dom/test-utils';

// After:
import { act } from 'react';

Se misturado com outras importações do test-utils:

// Before:
import { act, Simulate, renderIntoDocument } from 'react-dom/test-utils';

// After  split the imports:
import { act } from 'react';
import { fireEvent, render } from '@testing-library/react'; // replaces Simulate + renderIntoDocument

2. Simulate → fireEvent

// Before  Simulate REMOVED in React 19:
import { Simulate } from 'react-dom/test-utils';
Simulate.click(element);
Simulate.change(input, { target: { value: 'hello' } });
Simulate.submit(form);
Simulate.keyDown(element, { key: 'Enter', keyCode: 13 });

// After:
import { fireEvent } from '@testing-library/react';
fireEvent.click(element);
fireEvent.change(input, { target: { value: 'hello' } });
fireEvent.submit(form);
fireEvent.keyDown(element, { key: 'Enter', keyCode: 13 });

3. Mapeamento Completo da API do react-dom/test-utils

4. Correções de Contagem de Chamadas do StrictMode

O StrictMode do React 19 não chama mais duas vezes useEffect em desenvolvimento. As asserções de espionagem que contam chamadas de efeito devem ser atualizadas.

Estratégia: sempre meça, nunca adivinhe:

# Run the failing test, read the actual count from the error:
npm test -- --watchAll=false --testPathPattern="[filename]" --forceExit 2>&1 | grep -E "Expected|Received"

// Before (React 18 StrictMode  effects ran twice):
expect(mockFn).toHaveBeenCalledTimes(2);  // 1 call × 2 (strict double-invoke)

// After (React 19 StrictMode  effects run once):
expect(mockFn).toHaveBeenCalledTimes(1);

// Render-phase calls (component body)  still double-invoked in React 19 StrictMode:
expect(renderSpy).toHaveBeenCalledTimes(2);  // stays at 2 for render body calls