📘 Tutorial TypeScript con Node.js y Express. ¡Crea tu API REST con tipos estáticos DESDE CERO!
En este tutorial, aprenderás cómo crear una API REST utilizando TypeScript, Node.js y Express. TypeScript es un lenguaje de programación que extiende JavaScript agregando tipos estáticos, lo cual te permite reducir errores durante el desarrollo y tener un código más robusto.
Antes de comenzar, asegúrate de tener Node.js instalado en tu máquina. Puedes descargarlo desde https://nodejs.org.
Paso 1: Configuración del proyecto
Lo primero que debemos hacer es crear una nueva carpeta para nuestro proyecto. Abre tu terminal y ejecuta el siguiente comando:
mkdir tutorial-typescript
Luego, ingresa al directorio recién creado:
cd tutorial-typescript
Ahora, inicialicemos nuestro proyecto de Node.js ejecutando el siguiente comando:
npm init -y
Este comando creará un archivo package.json con la configuración básica de nuestro proyecto.
Paso 2: Instalación de dependencias
Para poder utilizar TypeScript, necesitamos instalarlo como una dependencia de desarrollo. Ejecuta el siguiente comando:
npm install typescript --save-dev
También necesitaremos instalar los tipos de TypeScript para Node.js y Express:
npm install @types/node @types/express --save-dev
Además, instalaremos Express como una dependencia regular:
npm install express
Ahora que tenemos todas las dependencias instaladas, podemos pasar al siguiente paso.
Paso 3: Configuración de TypeScript
En la raíz de tu proyecto, crea un archivo llamado tsconfig.json con la siguiente configuración:
{
"compilerOptions": {
"target": "es6",
"module": "commonjs",
"outDir": "dist",
"strict": true,
"esModuleInterop": true
},
"include": [
"src/**/*.ts"
],
"exclude": [
"node_modules"
]
}
Esta configuración le indica al compilador de TypeScript cómo debe transpilar nuestro código y dónde debe colocar los archivos de salida.
Paso 4: Creación de la API REST
Crea una carpeta llamada src en la raíz de tu proyecto. Dentro de esta carpeta, crea un archivo llamado index.ts con el siguiente código:
import express, { Request, Response } from 'express';
const app = express();
const port = 3000;
app.get('/', (req: Request, res: Response) => {
res.send('¡Hola TypeScript con Node.js y Express!');
});
app.listen(port, () => {
console.log(`Servidor corriendo en http://localhost:${port}`);
});
En este código, estamos importando el módulo express y las interfaces Request y Response de este módulo. Luego, estamos creando una instancia de la aplicación express y definiendo un punto de entrada en la ruta ‘/’ que devuelve un mensaje de saludo.
Finalmente, iniciamos el servidor en el puerto 3000.
Paso 5: Compilación y ejecución del proyecto
Para compilar nuestro proyecto TypeScript, ejecuta el siguiente comando:
npx tsc
Esto generará los archivos JavaScript en la carpeta dist.
Una vez que la compilación haya finalizado, puedes ejecutar tu API REST con el siguiente comando:
node dist/index.js
¡Felicidades! Ahora podrás acceder a tu API REST en http://localhost:3000 y ver el mensaje de saludo.
En este tutorial, has aprendido cómo crear una API REST utilizando TypeScript, Node.js y Express. Has visto cómo configurar el proyecto, instalar las dependencias necesarias, configurar TypeScript y crear una API básica. Ahora puedes explorar y expandir tu API agregando más rutas, controladores y lógica de negocio.
¡Diviértete creando tu propia API REST con tipos estáticos!
Me hubiera gustado que levantaras los Unit test ya que es super importante
Excelente video muy didáctico, una pregunta tendrás algún vídeo donde muestres como generar el build para producción del proyecto??? Gracias por compartir tu conocimiento. Saludos.
Está genial el video gracias Midu, solo una aclaración, el código NO SE COMPILA, cuando pasa de typescript a Javascript esto se llama TRANSPILAR, solo esa aclaración ya que varias veces dices "compilar".
Sacas Eslint de la nada, o el thinder client como si todos supieramos que es y nisiquiera explicas que se tiene que instalar aparte, por algo es tutorial desde cero, otras cosas las sobreexplicas sin ser necesario 👎
Excelente, aprendo mucho de ti, gracias por todos tus aportes.
Que theme usa? me gusta mucho el diseño
tengo una duda si escribo el codigo en TS -> se convierte a JS que sentido tiene si node correria es el en start JS y en dev en TS, lo digo en el caso de correr solo TS sin convertir a JS y ya ?
Excelente!!! Ahora una explicación con este mismo código de cómo se hace el deploy a AWS, usando Elastic B o quizás transformar esto a funciones lambda!
Te quiero bro
Yo guardaria el archivo utils.ts dentro de la carpeta libs. Excelente video he aprendido bastante, muchas gracias. 👍
esto es nivel junior?
jeje yo que ya habia visto el error desde que probe antes , pero esperando como lo encuentra terrible y no saber como decir ahi esta, ahi ahi (tremendo crack aprendi bastante recien estoy comenzando con typescript y me parecio muy bueno gracias a lo genial que lo explico )
La explicación que se da a partir del 23:30 es magistral. Me ayudó mucho. Gracias!
Alto curso, Midudev…!!! espectacular…!!! Muchas gracias.
Genial!, consulta el repositorio esta?
esto aún es nivel pollo. no he visto en este video y otros de este canal el asunto de manejar las rutas como un verdadero profesional. eso de andar importando todas las rutas de venir y por haber, en el archivo app.ts y luego tener que usarlas en ese mismo archivo con app.use….. es una chapuza!!!!!!!. ASÍ LO HACEN EL 99%!!!!!!!! ahora imagínense que el directorio routes tenga más o menos la siguiente estructura:
routes
index.ts
items.ts
otro.ts
otromas.ts
unomas.ts
…
…
subCarpeta
…
…
100 archivos aquí .ts
…
…
100 carpetas más aquí, cada una con cientos de archivos .ts
…
…
qué pretenden?
llenar el app.ts a punta de imports y use??????? naaahhhhh, pero nadie hasta ahora ha subido un ejemplo de como lidiar con esta situación!
Que extensión es la que te dice 0 complementación encima de las interfaces?
si no es mucha molestia, alguien sabe como se llama la extensión que te dice lo errores en el código sin tener que hacer hover en el error?
sos un tipazo
Super bien explicado, genial que dejes los errores para saber como encontrarlos. Muchas gracias Midu