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.atexiste 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
libqui déclarewindow,documentetfetch. Son absence est volontaire côté serveur.- Polyfill
Du code d'exécution qui ajoute une fonction manquante. Ni
targetnilibn'en produisent — ils ne font que décrire.
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.