TypeScriptOptions tsconfig
"outDir" et "rootDir"
Le dossier où va le code compilé et le dossier des sources.
Exemple
#JSON
{
"compilerOptions": {
"rootDir": "./src",
"outDir": "./dist",
"declaration": true
},
"include": ["src"]
}Définition et utilisation
#L’option outDir désigne le dossier des fichiers JavaScript générés (et éventuellement des fichiers .d.ts). Sans elle, le compilateur écrit le résultat à côté des fichiers sources, ce qui met vite du désordre dans le projet.
rootDir définit le dossier de base des sources. La structure des dossiers à l’intérieur de rootDir est reproduite dans outDir : le fichier src/utils/format.ts se retrouve dans dist/utils/format.js.
Dans les projets avec un bundler ou un framework (Next.js, Vite), la compilation est assurée par l’outil de build, et tsconfig contient souvent noEmit: true. outDir n’a alors aucune importance.
Syntaxe
#Syntaxe
"rootDir": "./src",
"outDir": "./dist"Bonnes pratiques
#- Ajoutez le dossier
distà.gitignore. Le code généré ne doit pas aller dans le dépôt. - L’option
declaration: truegénère des fichiers.d.tsavec les types, nécessaires pour publier des bibliothèques.
Entrées associées
#- "include" et "exclude"Quels fichiers le compilateur prend en compte et lesquels il ignore.
- "target"La version de JavaScript vers laquelle le compilateur transforme votre code.
- "module"Le format de modules du code généré et la manière de comprendre les imports.
- "declaration"Génère des fichiers .d.ts avec les types à côté du JavaScript compilé.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.