Test en TypeScript : aperçu des frameworks et outils

Test en TypeScript : aperçu des frameworks et outils modernes

TypeScript est un sur-ensemble strictement typé de JavaScript, largement utilisé dans le développement web moderne. Cependant, le typage en lui-même ne garantit pas l'absence d'erreurs logiques. Pour assurer la qualité du code, des tests rigoureux sont nécessaires. Dans cet article, nous analyserons les principaux frameworks et outils pour tester les applications TypeScript, leurs spécificités et des exemples d'utilisation.

Pourquoi tester le code TypeScript ?

Bien que TypeScript vérifie les types à la compilation, il ne protège pas contre les erreurs d'exécution, la logique métier incorrecte ou les régressions. Les tests aident à :

• Détecter les erreurs avant la mise en production ;
• Documenter le comportement des fonctions et des modules ;
• Simplifier le refactoring et la maintenance du code ;
• Accélérer le processus de développement grâce à l'automatisation des vérifications.

Frameworks populaires pour tester TypeScript

1. Jest — un choix universel

Jest est le framework le plus populaire, créé par Facebook. Il prend en charge TypeScript « prêt à l'emploi » via le package ts-jest ou la configuration Babel. Jest inclut un test runner, une bibliothèque d'assertions, le mocking et les rapports de couverture.

Installation et configuration :

npm install --save-dev jest ts-jest @types/jestnpx ts-jest config:init

Exemple de test unitaire pour une fonction d'addition :

// sum.tsexport function sum(a: number, b: number): number {  return a + b;}

// sum.test.tsimport { sum } from './sum';

describe('sum function', () => {  test('adds 1 + 2 to equal 3', () => {    expect(sum(1, 2)).toBe(3);  });

  test('adds negative numbers', () => {    expect(sum(-1, -2)).toBe(-3);  });});

2. Vitest — une alternative rapide pour les projets Vite

Vitest est un framework moderne qui utilise Vite pour la compilation. Il est compatible avec l'API de Jest, mais fonctionne beaucoup plus rapidement grâce à la prise en charge native des modules ES et du HMR. Idéal pour les projets Vue, React ou Svelte.

Exemple de configuration :

// vitest.config.tsimport { defineConfig } from 'vitest/config';

export default defineConfig({  test: {    globals: true,    environment: 'node',  },});

Test utilisant describe/it :

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

function multiply(a: number, b: number): number {  return a * b;}

describe('multiply', () => {  it('should multiply two numbers', () => {    expect(multiply(3, 4)).toBe(12);  });});

3. Mocha + Chai — la flexibilité classique

Mocha est un test runner flexible, souvent utilisé avec la bibliothèque d'assertions Chai. Pour TypeScript, il faudra installer ts-node et @types/mocha supplémentaires. Mocha offre de nombreux plugins et personnalisations.

Exemple :

import { expect } from 'chai';

function greet(name: string): string {  return `Hello, ${name}!`;}

describe('greet', () => {  it('should return a greeting', () => {    expect(greet('Alex')).to.equal('Hello, Alex!');  });});

Outils pour les tests end-to-end (E2E)

4. Playwright — un outil E2E moderne

Playwright de Microsoft prend en charge TypeScript nativement, permet de tester Chromium, Firefox et WebKit. Il sait gérer les requêtes réseau, émuler des appareils mobiles et prendre des captures d'écran.

Installation :

npm init playwright@latest

Exemple de test pour vérifier le titre d'une page :

import { test, expect } from '@playwright/te