"isolatedModules"

Veille à ce que chaque fichier puisse être traduit en JavaScript séparément, sans rien savoir du reste du projet.

Sur cette page

Exemple

#
JSON
{
  "compilerOptions": {
    "isolatedModules": true,
    "noEmit": true
  }
}

Définition et utilisation

#

Les outils comme esbuild, SWC et Babel, utilisés par Vite, Next.js ou Vitest, traduisent TypeScript en JavaScript fichier par fichier et n’analysent pas les types. L’option isolatedModules signale les constructions qui ne peuvent pas être traduites correctement de cette façon, avant qu’elles ne se transforment en erreur dans un programme en cours d’exécution.

L’option ne modifie pas le code généré, elle ajoute seulement des vérifications. Elle exige le plus souvent de marquer les réexports de types avec export type, et interdit de lire des valeurs depuis un declare const enum, car un outil qui ne voit qu’un seul fichier ne sait pas si un nom est un type, ni quelle valeur se cache derrière une constante.

Les modèles de projet l’activent généralement, y compris le fichier créé par tsc --init depuis TypeScript 5.9. L’option verbatimModuleSyntax active les mêmes vérifications, isolatedModules est donc superflu avec elle.

Syntaxe

#
Syntaxe
"isolatedModules": true

Plus d’exemples

#
Réexport d’un type
TypeScript
// src/index.ts
export { Course, formatTitle } from './course'
// Erreur : Re-exporting a type when 'isolatedModules' is enabled requires using 'export type'.
L’export corrigé
TypeScript
// src/index.ts
export { type Course, formatTitle } from './course'

// ou sur deux lignes :
// export type { Course } from './course'
// export { formatTitle } from './course'

Bonnes pratiques

#
  • Vous utilisez Vite, Next.js, esbuild ou SWC ? Activez isolatedModules (ou verbatimModuleSyntax). Le compilateur vous avertira du code que le bundler traduirait de travers.
  • L’option n’accélère pas tsc. La vérification des types couvre toujours tout le projet, seul l’ensemble des constructions autorisées change.
  • Pour réexporter des types, écrivez export type { … } ou marquez les noms individuellement : export { type A, b }.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.