Setup de TypeScript

Setup y configuración

Antes de comenzar a escribir código en TypeScript, es necesario configurar un entorno de desarrollo. Esto puede hacerse instalando TypeScript a través de npm (Node Package Manager) y configurando un archivo tsconfig.json en el directorio raíz de su proyecto. Este archivo especifica la configuración de compilación de TypeScript, incluyendo la versión de TypeScript que se desea usar y las opciones de compilación.

Por ejemplo, aquí está un archivo tsconfig.json básico:

{
    "compilerOptions": {
        "target": "es5",
        "module": "commonjs",
        "strict": true
    }
}

Escribiendo y compilando

Para poder comenzar a escribir TypeScript primero deberás tener las herramientas adecuadas.

tsc: el compilador TypeScript es una herramienta de línea de comandos que permite compilar el código TypeScript en JavaScript.

ts-node: ts-node es una herramienta que permite ejecutar directamente código TypeScript en un entorno Node.js sin la necesidad de compilar previamente

Instalación de TSC y TS-Node

Para instalar TSC y TS-Node en un proyecto, primero es necesario tener Node.js y npm instalados en el sistema. A continuación, se describen los pasos para instalar ambas herramientas:

Abre una terminal y navega hasta el directorio de tu proyecto.

Ejecuta el siguiente comando para instalar TSC como un paquete local en tu proyecto:

npm install typescript --save-dev

Ejecuta el siguiente comando para instalar TS-Node como un paquete local en tu proyecto:

npm install ts-node --save-dev

Una vez que se han instalado TSC y TS-Node, es posible usarlos de la siguiente manera:

Compilación de TypeScript a JavaScript: para compilar el código TypeScript en JavaScript, se puede ejecutar el siguiente comando en la terminal:

npx tsc

Ejecución de TypeScript directamente: para ejecutar directamente el código TypeScript en un entorno Node.js, se puede ejecutar el siguiente comando en la terminal:

npx ts-node [nombre_del_archivo].ts

fijarse que el archivo que se corre a través de ts-node tiene la extensión “.ts”. si ya tiene un proyecto JavaScript existente deberá migrar todos los archivos a la extensión “.ts”

Modo watch en TSC y TS-Node

El modo watch es una función que permite ver los cambios en los archivos en tiempo real. Al activar el modo watch, cada vez que se guarda un archivo, se compila automáticamente el código y se muestran los resultados en la terminal.

Para activar el modo watch en TSC, se puede ejecutar el siguiente comando en la terminal:

npx tsc -w

Para activar el modo watch en TS-Node, se puede ejecutar el siguiente comando en la terminal:

npx ts-node -w [nombre_del_archivo].ts

En este caso, [nombre_del_archivo].ts es el archivo que se quiere ver en tiempo real. Para ver todos los archivos de un proyecto, se puede usar el siguiente comando:

npx ts-node -w -r tsconfig-paths/register src/server.ts

Este comando activa el modo watch y registra todos los archivos de la carpeta src en el proyecto donde src/server.ts es el archivo de punto de entrada de la aplicación.

Aplicar TypeScript junto a Nodemon

Es común que en un proyecto NodeJS utilicemos la herramienta Nodemon para configurar nuestro ambiente de desarrollo y a la vez obtener la funcionalidad de observar los cambios en los archivos del proyecto.