Chai pour JavaScript (Node.js) : guide complet avec exemples

1. Qu'est-ce que Chai et pourquoi l'utiliser ?

Chai est une bibliothèque d'assertions puissante et flexible dans l'écosystème JavaScript, conçue pour écrire des tests. Elle offre au développeur un large éventail d'outils pour vérifier le comportement attendu du code. L'objectif principal de Chai est de rendre le processus d'écriture des tests intuitif, lisible et expressif, quel que soit le style de test que vous préférez : le TDD (Test-Driven Development) classique ou le BDD (Behavior-Driven Development) plus moderne.

Pourquoi utiliser Chai ? Dans le développement logiciel, il est crucial de s'assurer que chaque fonction, module ou composant fonctionne exactement comme prévu. Au lieu de vérifier manuellement chaque valeur avec des if...else et de lever des exceptions, Chai propose une API élégante. Elle permet d'écrire des assertions qui ressemblent à des phrases en français : expect(foo).to.be.a('string') ou assert.equal(3, 3). Cela simplifie considérablement la lecture, la maintenance et le débogage des tests. Chai n'est pas un exécuteur de tests (comme Mocha ou Jest), elle fonctionne en tandem avec eux, fournissant une couche pour vérifier les conditions.

Chai est particulièrement populaire dans l'environnement Node.js, mais peut également être utilisée dans le navigateur. Elle prend en charge trois interfaces principales : expect (style BDD, chaînage de méthodes), should (style BDD, extension de prototypes) et assert (style TDD, classique). Grâce à sa modularité et à son vaste écosystème de plugins (pour JSON, DOM, Promise, etc.), Chai est une solution universelle pour tester pratiquement n'importe quel code JavaScript.

2. Installation

L'installation de Chai dans un projet Node.js se fait via le gestionnaire de paquets npm. Il est recommandé de l'installer en tant que dépendance de développement (devDependency), car la bibliothèque n'est pas nécessaire dans la version de production.

npm install --save-dev chai

Si vous utilisez yarn :

yarn add --dev chai

Après l'installation, vous pouvez importer Chai dans votre fichier de test. Cela se fait généralement de deux manières :

// Import du module entier (recommandé pour Node.js)
const chai = require('chai');

// Ou, si vous utilisez les modules ES (type: "module" dans package.json)
import chai from 'chai';

3. Démarrage rapide

Écrivons un test simple en utilisant Chai et l'exécuteur de tests populaire Mocha. Commencez par installer Mocha : npm install --save-dev mocha.

Créez un fichier test.js :

const chai = require('chai');
const expect = chai.expect; // Utilisation du style BDD

// Fonction à tester
function addition(a, b) {
    return a + b;
}

// Description de la suite de tests (suite)
describe('Fonction addition', function() {
    // Test spécifique (spec)
    it('doit additionner correctement deux nombres', function() {
        // Assertion
        expect(addition(2, 3)).to.equal(5);
    });

    it('doit retourner un nombre', function() {
        expect(addition(2, 3)).to.be.a('number');
    });
});

Exécutez le test avec la commande npx mocha test.js. Vous verrez un rapport vert indiquant la réussite des tests. Cet exemple illustre la structure de base : describe pour regrouper les tests, it pour décrire un test spécifique et expect pour vérifier le résultat.

4. Méthodes et fonctions principales

Chai propose trois API principales : expect, should et assert. Nous examinerons les méthodes les plus couramment utilisées avec expect, car c'est la plus populaire et la plus flexible.

4.1. expect(valeur).to.