Formations — 1 037 leçons en français

Accueil › TypeScript › Compilation, tsc et l'éditeur

Compilation, tsc et l'éditeur

Démarrer avec TypeScriptdebutant

TypeScript ne s'exécute pas. Un navigateur et Node reçoivent du JavaScript, et c'est tsc — ou un autre outil — qui l'a produit.

npm install --save-dev typescript
npx tsc --init          # crée tsconfig.json
npx tsc                 # vérifie et émet le JavaScript
npx tsc --noEmit        # vérifie seulement
npx tsc --watch         # revérifie à chaque enregistrement

tsc fait deux choses qui se séparent très bien :

  1. il vérifie les types ;
  2. il émet du JavaScript.

--noEmit ne garde que la première. C'est la commande à mettre dans votre intégration continue, parce que dans un projet moderne la production du bundle est déjà le travail de Vite, esbuild ou SWC — et ces outils ne vérifient aucun type. Ils effacent les annotations, ce qui est rapide précisément parce qu'il n'y a aucune analyse.

L'éditeur n'est pas le compilateur

Les erreurs soulignées dans votre éditeur viennent du service de langage, qui analyse les fichiers que vous avez ouverts. tsc analyse tout ce que tsconfig.json désigne.

Même vérificateur, même configuration, périmètre différent. D'où la situation classique : zéro erreur à l'écran, douze en intégration continue. Celui qui tranche est tsc.

npx tsc --noEmit        # la seule réponse qui fasse autorité

Les termes à connaître

tsc

Le compilateur officiel. Il vérifie les types et produit du JavaScript. C'est lui qui fait autorité : si tsc passe, le code est accepté.

Service de langage

Le processus qui alimente l'éditeur en erreurs, autocomplétion et renommages. Il analyse les fichiers ouverts, pas le projet entier.

tsc --noEmit

Vérifier sans écrire un seul fichier. L'usage attendu en intégration continue et avant un commit : un vérificateur, pas un compilateur.

tsconfig.json

Le fichier qui définit le périmètre du projet (include, exclude) et les règles de vérification. Sa présence est ce qui fait qu'un dossier est « un projet TypeScript ».

Transpilation sans vérification

Ce que font esbuild, SWC et Vite : ils effacent les types et produisent du JavaScript sans les vérifier. Rapide, mais aveugle.

Fichier de déclaration

Un .d.ts : les types sans l'implémentation. Produit par declaration: true, il permet à un autre projet de consommer votre code typé.

Lire l'explication détaillée et faire le quiz →

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.