Le compilateur TypeScript et le fichier de configuration tsconfig.json

Le compilateur TypeScript (tsc) et le fichier de configuration tsconfig.json jouent un rôle central dans le développement avec TypeScript.

Compilateur TypeScript (tsc)

Le compilateur TypeScript (tsc) est l'outil qui convertit le code TypeScript (.ts ou .tsx pour TypeScript avec JSX) en JavaScript équivalent. TypeScript étant un sur-ensemble de JavaScript, le code doit être "transpilé" en JavaScript pour être exécuté sur des navigateurs ou dans des environnements comme Node.js.

Pour utiliser tsc, vous devez d'abord installer TypeScript, généralement via npm (le gestionnaire de paquets de Node.js) :

npm install -g typescript

Une fois installé, vous pouvez compiler un fichier TypeScript en utilisant la commande :

tsc monFichier.ts

Cela générera un fichier JavaScript correspondant (monFichier.js).

Fichier de Configuration tsconfig.json

tsconfig.json est un fichier de configuration pour TypeScript. Il permet de spécifier différentes options pour le processus de compilation de vos fichiers TypeScript.

Pour générer un tsconfig.json par défaut, vous pouvez utiliser :

tsc --init

Ce fichier peut être personnalisé pour configurer divers aspects de votre projet TypeScript, tels que :

• cible (target) : spécifie la version ECMAScript de sortie (par exemple, es5, es6).
• module (module) : détermine le système de modules (par exemple, commonjs, es2015).
• strict (strict) : active une vérification de type plus stricte.
• outDir (outDir) : définit le dossier de sortie pour les fichiers JavaScript compilés.
• include et exclude : spécifie les fichiers à inclure ou à exclure de la compilation.
• et beaucoup d'autres options : pour gérer les fichiers source maps, la résolution des modules, etc.

Par exemple, un tsconfig.json simple peut ressembler à ceci :

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "strict": true,
    "outDir": "./dist"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "**/*.test.ts"]
}

Ce fichier configure TypeScript pour compiler le code en ES6, utiliser le format de module CommonJS, appliquer des vérifications strictes, et placer les fichiers JavaScript compilés dans le dossier ./dist. Il inclut tous les fichiers .ts dans le dossier src et exclut les fichiers dans node_modules et les fichiers de test.

Utilisation

Lorsque vous avez un tsconfig.json dans votre projet, vous pouvez simplement exécuter tsc sans arguments dans le répertoire racine de votre projet pour compiler tous vos fichiers TypeScript conformément aux options spécifiées dans tsconfig.json.

Le duo tsc et tsconfig.json fournit une base solide et configurable pour travailler avec TypeScript, permettant de tirer parti de ses fonctionnalités avancées de typage tout en produisant du JavaScript compatible et optimisé pour votre environnement cible.