Chai para JavaScript (Node.js): guia completo com exemplos

1. O que é Chai e para que serve?

Chai é uma biblioteca de assertions (afirmações) poderosa e flexível para o ecossistema JavaScript, projetada para escrever testes. Ela oferece ao desenvolvedor um amplo conjunto de ferramentas para verificar o comportamento esperado do código. O principal objetivo do Chai é tornar o processo de escrita de testes intuitivo, legível e expressivo, independentemente do estilo de teste que você prefere: o clássico TDD (Test-Driven Development) ou o mais moderno BDD (Behavior-Driven Development).

Para que serve o Chai? No desenvolvimento de software, é fundamental garantir que cada função, módulo ou componente funcione exatamente como esperado. Em vez de verificar manualmente cada valor com if...else e lançar exceções, o Chai oferece uma API elegante. Ela permite escrever afirmações que parecem frases em português: expect(foo).to.be.a('string') ou assert.equal(3, 3). Isso simplifica muito a leitura, manutenção e depuração dos testes. O Chai não é um test runner (como Mocha ou Jest), ele funciona em conjunto com eles, fornecendo a camada de verificação das condições.

Chai é especialmente popular no ambiente Node.js, mas também pode ser usado no navegador. Ele suporta três interfaces principais: expect (estilo BDD, com encadeamento de chamadas), should (estilo BDD, estendendo protótipos) e assert (estilo TDD, clássico). Graças à sua modularidade e à enorme quantidade de plugins (por exemplo, para trabalhar com JSON, DOM, Promises), o Chai é uma solução versátil para testar praticamente qualquer código JavaScript.

2. Instalação

A instalação do Chai em um projeto Node.js é feita através do gerenciador de pacotes npm. Recomenda-se instalá-lo como dependência de desenvolvimento (devDependency), já que a biblioteca não é necessária na build de produção.

npm install --save-dev chai

Se você usa yarn:

yarn add --dev chai

Após a instalação, você pode importar o Chai no seu arquivo de teste. Geralmente, isso é feito de uma das duas maneiras:

// Importando o módulo inteiro (recomendado para Node.js)
const chai = require('chai');

// Ou, se você usa ES Modules (type: "module" no package.json)
import chai from 'chai';

3. Primeiros passos

Vamos escrever um teste simples usando Chai e o popular test runner Mocha. Primeiro, instale o Mocha: npm install --save-dev mocha.

Crie um arquivo test.js:

const chai = require('chai');
const expect = chai.expect; // Usando o estilo BDD

// Função que será testada
function somar(a, b) {
    return a + b;
}

// Descrevendo o conjunto de testes (suite)
describe('Função somar', function() {
    // Teste específico (spec)
    it('deve somar dois números corretamente', function() {
        // Afirmação (assertion)
        expect(somar(2, 3)).to.equal(5);
    });

    it('deve retornar um número', function() {
        expect(somar(2, 3)).to.be.a('number');
    });
});

Execute o teste com o comando npx mocha test.js. Você verá um relatório verde indicando que os testes passaram. Este exemplo demonstra a estrutura básica: describe para agrupar testes, it para descrever um teste específico e expect para verificar o resultado.

4. Métodos e funções principais

Chai oferece três APIs principais: expect, should e assert. Vamos explorar os métodos mais usados com o expect, que é o mais popular e flexível.

4.1. expect(valor).to.