Formations — 1 037 leçons en français

Accueil › TypeScript › target, lib et module

target, lib et module

Configurer le compilateurintermediaire

Deux options, deux rôles distincts, et c'est la confusion la plus répandue du fichier de configuration.

target change le code produit

const doubler = (n: number) => n * 2;

Avec target: "ES2022", la fonction fléchée est conservée telle quelle. Avec target: "ES5", le compilateur produit une function classique. target décide quelles syntaxes sont transformées.

lib change les types disponibles

const dernier = ["a", "b"].at(-1);

Cette ligne compile si lib contient ES2022, et produit TS2550 : « at » n'existe pas sur « string[] ». Changez « lib » sinon. lib décide quelles déclarations le compilateur connaît.

Ils sont indépendants

{
  "compilerOptions": {
    "target": "ES5",
    "lib": ["ES2022", "DOM"]
  }
}

Cette configuration compile at(-1) sans erreur et produit du code qui échoue sur un moteur ancien : lib a promis une méthode que rien n'apporte. Un target bas ne produit jamais de polyfill — il ne touche qu'à la syntaxe.

Quand lib est absent, il est déduit de target. C'est ce défaut qui masque la distinction tant qu'on n'écrit pas les deux.

module et moduleResolution

module décide de la forme des imports produits — import conservé avec ESNext, require avec CommonJS. moduleResolution décide de la façon de trouver le fichier derrière une chaîne d'import. Les deux sont distincts, et un import introuvable vient presque toujours du second.

Les termes à connaître

target

La version du langage que le compilateur produit. Elle décide quelles syntaxes sont transformées en code plus ancien.

lib

Les déclarations de types disponibles pendant la vérification. Elle décide si Array.prototype.at existe pour le compilateur.

module

La forme des imports et exports dans le code produit — ESNext, CommonJS, NodeNext, Preserve.

moduleResolution

L'algorithme de recherche d'un fichier à partir d'une chaîne d'import. Distinct de module, et souvent la vraie cause d'un import introuvable.

DOM

Une bibliothèque de lib qui déclare window, document et fetch. Son absence est volontaire côté serveur.

Polyfill

Du code d'exécution qui ajoute une fonction manquante. Ni target ni lib n'en produisent — ils ne font que décrire.

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.