Chuck's Academy

TypeScript Básico

Configuración de Proyectos TypeScript

Uno de los beneficios de usar TypeScript es su flexibilidad a la hora de configurar los proyectos. Esto nos permite personalizar el comportamiento del compilador y optimizar el proceso de desarrollo. La clave de esta configuración está en el archivo tsconfig.json, donde se definen las opciones del compilador y otros ajustes del proyecto.

El Archivo tsconfig.json

El archivo tsconfig.json es el archivo de configuración de TypeScript que define cómo se compila el código. Puedes generar este archivo automáticamente utilizando el siguiente comando:

bash
"Este comando genera un archivo tsconfig.json con las configuraciones predeterminadas para tu proyecto."

Esta imagen muestra una captura de pantalla utilizando tsconfig.jsonEsta imagen muestra una captura de pantalla utilizando tsconfig.json

Estructura Básica de tsconfig.json

Un archivo básico de tsconfig.json tiene la siguiente estructura:

json
"Este archivo define las opciones del compilador bajo compilerOptions. Por ejemplo, target especifica la versión de ECMAScript, module define el sistema de módulos, y strict habilita el modo de tipado estricto."

Opciones Comunes en compilerOptions

A continuación, veremos algunas de las opciones más utilizadas en el archivo tsconfig.json.

target

La opción target define a qué versión de ECMAScript debe ser transpilado el código TypeScript. Algunos valores comunes son:

  • "es5": Compatible con la mayoría de los navegadores.
  • "es6": Permite utilizar características de ECMAScript 6, como let y const.
json
"Aquí, la opción target está configurada en es6, lo que significa que el código TypeScript será transpilado a ECMAScript 6."

module

La opción module especifica el sistema de módulos que se utilizará. Algunos valores comunes son:

  • "commonjs": Sistema de módulos utilizado en Node.js.
  • "esnext": Utiliza el sistema de módulos nativo de ECMAScript.
json
"En este ejemplo, se utiliza el sistema de módulos commonjs, que es común en entornos de Node.js."

strict

La opción strict habilita el modo estricto de TypeScript, que incluye varias configuraciones de seguridad, como noImplicitAny y strictNullChecks. Esto ayuda a detectar más errores en tiempo de desarrollo.

json
"En este archivo, la opción strict está habilitada, lo que activa el modo de tipado estricto de TypeScript, ayudando a prevenir errores."

esModuleInterop

Esta opción facilita la interoperabilidad entre módulos de ECMAScript y CommonJS, lo que es útil cuando trabajamos con librerías de JavaScript que utilizan diferentes sistemas de módulos.

json
"Con esModuleInterop habilitado, es más fácil importar y exportar módulos entre sistemas de módulos diferentes, como ECMAScript y CommonJS."

Inclusión y Exclusión de Archivos

TypeScript permite incluir y excluir archivos en la compilación utilizando las opciones include y exclude. Esto nos da control sobre qué archivos y carpetas serán procesados por el compilador.

Ejemplo de Inclusión

json
"Aquí, estamos incluyendo todos los archivos dentro de la carpeta src para que sean compilados."

Ejemplo de Exclusión

json
"Este archivo de configuración excluye las carpetas node_modules y dist del proceso de compilación, ya que estas carpetas contienen dependencias o archivos generados que no necesitan ser procesados."

Configuración para Desarrollo y Producción

TypeScript permite configurar diferentes opciones para desarrollo y producción. Una estrategia común es usar diferentes archivos de configuración o sobrescribir algunas opciones para cada entorno.

Configuración de Desarrollo

json
"En el entorno de desarrollo, la opción sourceMap está habilitada para facilitar la depuración del código. Además, noEmit está en false, lo que permite que se generen archivos JavaScript."

Configuración de Producción

json
"En la configuración de producción, los comentarios son eliminados del código generado gracias a removeComments, y noEmitOnError asegura que no se generen archivos si hay errores de compilación."

Conclusión

En este capítulo, hemos aprendido a configurar proyectos TypeScript utilizando el archivo tsconfig.json. Esta configuración nos permite personalizar el comportamiento del compilador, optimizando nuestro flujo de trabajo para diferentes entornos, como desarrollo y producción.


Pregúntame lo que sea