Accueil › TypeScript › Vitest et TypeScript
Vitest et TypeScript
Tester du TypeScriptavance
Vitest exécute vos tests TypeScript sans jamais vérifier vos types. Les fichiers passent par esbuild, qui efface les annotations et s'arrête là.
// panier.ts
export function total(lignes: { prix: number }[]): number {
return lignes.reduce((s, l) => s + l.prix, 0);
}
total("pas un tableau"); // ❌ TS2345 — et pourtant les tests passent
L'erreur est réelle : tsc la signale. Mais la suite de tests l'ignore, parce
qu'au moment de l'exécution il ne reste plus un type dans le fichier.
Un projet TypeScript testé a donc deux barrières, et il faut les deux :
{
"scripts": {
"typecheck": "tsc --noEmit",
"test": "vitest run"
}
}
La configuration minimale tient en quelques lignes :
// vitest.config.ts
import { defineConfig } from "vitest/config";
export default defineConfig({
test: {
environment: "node",
include: ["src/**/*.test.ts"],
},
});
Le fichier est lui-même en TypeScript et defineConfig type l'objet : une
option mal orthographiée est refusée à l'écriture, pas découverte à
l'exécution.
Une suite verte prouve que le code fait ce qu'on a demandé. Elle ne prouve pas qu'il compile.
Les termes à connaître
- Transpilation sans vérification
Vitest fait transformer les fichiers par esbuild, qui efface les annotations sans les contrôler. Une suite verte ne dit donc rien de la justesse des types.
- tsc --noEmit
Lance le compilateur pour vérifier, sans produire de fichier. C'est la commande qui vérifie réellement les types, et elle est indépendante des tests.
- Fichier par fichier
esbuild transforme chaque fichier isolément, sans voir les autres. Certaines écritures, comme un ré-export de type non marqué, n'y survivent pas.
- import type
Marque un import comme purement typé. L'instruction disparaît entièrement à la transformation, ce qui évite d'importer un module pour rien.
- verbatimModuleSyntax
Option qui exige que tout import de type soit marqué
import type. Elle aligne le compilateur sur ce qu'un transformateur fichier par fichier peut comprendre.- Double barrière
Deux commandes distinctes dans l'intégration continue — le compilateur et la suite de tests — parce qu'aucune ne couvre ce que l'autre vérifie.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.