El archivo tsconfig.json es un archivo de formato JSON que nos permite señalar los archivos de nivel raíz y las diferentes opciones del compilador para la configuración que requieren compilar proyectos basados en TypeScript. La existencia de este archivo en un proyecto especifica que el directorio dado es la raíz de la carpeta del proyecto de TypeScript.
El archivo tsconfig.json consiste principalmente en la información de lo siguiente:
- Opciones del compilador
- CompileOnSave
- archivos
- Incluir
- Excluir
Tomemos un archivo de ejemplo del archivo tsconfig.json y comprendamos el propósito de cada una de sus partes.
tsconfig.json
{ "compileOnSave": true, "compilerOptions": { "module": "system", "noImplicitAny": true, "removeComments": true, "allowUnreachableCode": false, "strictNullChecks": true, "outFile": "../JS/TypeScript/HelloWorld.js", "sourceMap": true }, "files": [ "program.ts", "sys.ts" ], "include": [ "src/**/*" ], "exclude": [ "node_modules", "src/**/*.spec.ts" ] }
CompilerOptions – Es una propiedad que permite especificar opciones adicionales al compilador de TypeScript. Dada una lista de algunas secciones de configuración opcionales de la propiedad compilerOptions que se necesita la mayor parte del tiempo:
- listFiles
- módulo
- outDir
- desarchivar
- rootDir
- sourceRoot
- allowUnreachableCode
- permitirJs
- noImplicitUseStrict
- estrictosNullChecks
{
“compilerOptions”: {
“módulo”: “sistema”,
“noImplicitAny”: verdadero,
“removeComments”: verdadero,
“allowUnreachableCode”: falso,
“strictNullChecks”: verdadero,
“outFile”: “../JS/TypeScript/ HelloWorld.js”,
“sourceMap”: verdadero
}
}
CompileOnSave: es una propiedad que se puede usar para indicarle al IDE que compile automáticamente los archivos TypeScript dados y genere la salida para los mismos.
{
«compileOnSave»: verdadero,
«compilerOptions»: {
«módulo»: «sistema»,
«noImplicitAny»: verdadero,
«removeComments»: verdadero,
«allowUnreachableCode»: falso,
«strictNullChecks»: verdadero,
«outFile»: «. ./JS/TypeScript/HelloWorld.js”,
“sourceMap”: verdadero
}
}
Archivos: es una propiedad que proporciona una lista de archivos TypeScript que incluirá el compilador. La URL de los archivos puede ser relativa o absoluta.
“archivos”: [
“programa.ts”,
“sys.ts”
]
Incluir: es una propiedad que le permite incluir una lista de archivos TypeScript utilizando el patrón de comodines glob.
«incluir»: [
«src/**/*»
]
Excluir: es una propiedad que le permite excluir una lista de archivos TypeScript utilizando el patrón de comodines glob.
«excluir»: [
«node_modules»,
«src/**/*.spec.ts»
]