Curso de Angular 13 : que es tsconfig json un archivo
Visión de conjunto
La presencia de un archivo tsconfig.json en un directorio indica que el directorio es la raíz de un proyecto de TypeScript. El archivo tsconfig.json especifica los archivos raíz y las opciones de compilación necesarias para compilar el proyecto. Un proyecto se compila de una de las siguientes maneras:
Usando tsconfig.json
Invocando tsc sin archivos de entrada, en cuyo caso el compilador busca el archivo tsconfig.json comenzando en el directorio actual y continuando en la cadena de directorio principal.
Invocando tsc sin archivos de entrada y una opción de línea de comando --project (o solo -p ) que especifica la ruta de un directorio que contiene un archivo tsconfig.json o una ruta a un archivo .json válido que contiene las configuraciones.
Cuando los archivos de entrada se especifican en la línea de comando, los archivos tsconfig.json se ignoran.
Ejemplos
Ejemplo de archivos tsconfig.json :
Usando la propiedad "files"
{
"compilerOptions": {
"module": "commonjs",
"noImplicitAny": true,
"removeComments": true,
"preserveConstEnums": true,
"sourceMap": true
},
"files":
"core.ts",
"sys.ts",
"types.ts",
"scanner.ts",
"parser.ts",
"utilities.ts",
"binder.ts",
"checker.ts",
"emitter.ts",
"program.ts",
"commandLineParser.ts",
"tsc.ts",
"diagnosticInformationMap.generated.ts"
}
Usar las propiedades "include" y "exclude"
Detalles
La propiedad "compilerOptions" se puede omitir, en cuyo caso se utilizan los valores predeterminados del compilador. Vea nuestra lista completa de opciones de compilador compatibles.
La propiedad "files" toma una lista de rutas de archivos relativas o absolutas. Las propiedades "include" y "exclude" toman una lista de patrones de archivos tipo glob. Los comodines glob admitidos son:
coincide con cero o más caracteres (excluyendo los separadores de directorio)
? coincide con cualquier carácter (sin incluir los separadores de directorio)
**/ recursivamente coincide con cualquier subdirectorio
Si un segmento de un patrón global incluye solo * o .* , Solo se incluyen los archivos con extensiones compatibles (por ejemplo, .tsx , .d.ts y .d.ts de forma predeterminada con .js y .jsx si allowJs se establece en verdadero) .
Si los "files" y "include" se especifican, el compilador establece de manera predeterminada todos los .ts TypeScript ( .ts , .d.ts y .tsx ) en el directorio y los subdirectorios que los contienen, excepto los excluidos con la propiedad "exclude" . Los archivos JS ( .js y .jsx ) también se incluyen si allowJs se establece en verdadero. Si se especifican las propiedades "files" o "include" , el compilador incluirá en su lugar la unión de los archivos incluidos por esas dos propiedades. Los archivos en el directorio especificado utilizando la opción del compilador "outDir" se excluyen siempre que no se especifique la propiedad "exclude" .
Los archivos incluidos con "include" se pueden filtrar utilizando la propiedad "exclude" . Sin embargo, los archivos incluidos explícitamente con la propiedad "files" siempre se incluyen independientemente de "exclude" . La propiedad "exclude" predetermina a excluir los node_modules , bower_components , jspm_packages y outDir cuando no se especifica.
También se incluyen todos los archivos a los que se hace referencia mediante archivos incluidos a través de las propiedades "files" o "include" . De forma similar, si un archivo B.ts es referenciado por otro archivo A.ts , entonces B.ts no se puede excluir a menos que el archivo de referencia A.ts también se especifique en la lista "exclude" .
Tenga en cuenta que el compilador no incluye archivos que pueden ser posibles resultados; por ejemplo, si la entrada incluye index.ts , entonces se index.d.ts e index.js . En general, no se recomienda tener archivos que difieran solo en la extensión uno al lado del otro.
Se tsconfig.json archivo tsconfig.json esté completamente vacío, lo que compila todos los archivos incluidos de manera predeterminada (como se describió anteriormente) con las opciones de compilación predeterminadas.
Las opciones del compilador especificadas en la línea de comando anulan las especificadas en el archivo tsconfig.json .