Mão na Massa: Seus Primeiros Testes Unitários (e o Truque dos Mocks!)

// arquivo: calculadora.js
function soma(a, b) {
  return a + b;
}

module.exports = soma; // Exporta a função para poder ser usada no teste

// arquivo: calculadora.test.js
const soma = require('./calculadora'); // Importa a função a ser testada

describe('Calculadora - Função Soma', () => {
  // 'describe' agrupa testes relacionados. É como um capítulo.

  it('deve somar 2 + 2 e retornar 4', () => {
    // 'it' (ou 'test') define um caso de teste específico.
    const resultado = soma(2, 2); // 1. Executa a função
    expect(resultado).toBe(4);   // 2. Verifica (Assert) se o resultado é o esperado
  });

  it('deve somar números negativos corretamente', () => {
    const resultado = soma(-5, 3);
    expect(resultado).toBe(-2);
  });
});

// arquivo: userService.js
const axios = require('axios'); // Dependência externa (HTTP client)

async function buscarUsuario(userId) {
  try {
    const response = await axios.get(`https://api.exemplo.com/users/${userId}`);
    return response.data;
  } catch (error) {
    console.error("Erro ao buscar usuário:", error);
    return null;
  }
}

module.exports = { buscarUsuario };

// arquivo: userService.test.js
const axios = require('axios');
const { buscarUsuario } = require('./userService');

jest.mock('axios'); // 1. Diz ao Jest: "Ei, quando alguém pedir 'axios', entregue um dublê!"

describe('UserService - buscarUsuario', () => {
  it('deve retornar os dados do usuário quando a API responde com sucesso', async () => {
    const dadosUsuarioMock = { id: 1, name: 'Devly User' };

    // 2. Configura o dublê: "Quando o 'get' do axios for chamado, finja que
    //    a API respondeu com sucesso e retorne estes dados"
    axios.get.mockResolvedValue({ data: dadosUsuarioMock });

    const usuario = await buscarUsuario(1); // 3. Chama a função (que usará o 'axios' mockado)

    // 4. Verifica se a função retornou o que o dublê prometeu
    expect(usuario).toEqual(dadosUsuarioMock);
    // 5. (Opcional) Verifica se o dublê foi chamado do jeito certo
    expect(axios.get).toHaveBeenCalledWith('https://api.exemplo.com/users/1');
  });

  it('deve retornar null quando a API responde com erro', async () => {
      // Configura o dublê para simular um erro
      axios.get.mockRejectedValue(new Error('API fora do ar'));

      const usuario = await buscarUsuario(2);

      expect(usuario).toBeNull();
  });
});