Skip to content

2. Configuración del entorno de trabajo

El documento original (2019) explicaba en detalle cómo instalar [Laragon], [Netbeans] y [Visual Studio Code] en Windows 10, con numerosas capturas de pantalla que ilustraban la configuración de PATH. En 2026, la instalación es mucho más sencilla: usaremos las siguientes herramientas.

  • [Visual Studio Code] para escribir el código TypeScript;
  • [Node.js], versión 26 o posterior—es la versión que dejó disponible, sin ninguna opción especial, el objeto [Temporal] presentado en el último capítulo de este documento;
  • [TypeScript], versión 6;
  • [tsx], una herramienta que ejecuta directamente un archivo .ts sin un paso previo de compilación; es la que usaremos para todos los scripts de este documento;
  • [npm] (Node Package Manager), incluido con Node.js, para instalar las bibliotecas que necesitaremos;

2.1. Verificación de las herramientas instaladas

Una vez instalados Node.js y Visual Studio Code, abra una terminal (ya sea dentro de VSCode o fuera de él) y verifique las versiones instaladas:

node --version

Resultado (la versión exacta puede variar; se recomienda 26.x o superior para este curso):

v22.22.2
npx tsc --version

Resultado de la ejecución:

Version 6.0.3

2.2. Configuración del proyecto de VSCode

La carpeta de código de este curso es la siguiente:

Image

Esta carpeta corresponde a la estructura de directorios completa de los scripts (typescript-nestjs-course-scripts/) presentada en la introducción de este documento, que usted ha descargado. Abra la subcarpeta typescript-fundamentals/ en VSCode: allí se encuentran los scripts de los primeros capítulos de este curso. Ya contiene, en su raíz, los dos archivos package.json y tsconfig.json; veámoslos.

2.2.1. El archivo package.json

Este archivo enumera las dependencias del proyecto. También especifica "type": "module", para que Node.js trate de forma nativa nuestros archivos como módulos de ECMAScript (con import/export), sin necesidad de una herramienta intermedia como ocurría en 2019 con el paquete esm.

{
  "type": "module",
  "scripts": {
    "check": "tsc --noEmit"
  },
  "devDependencies": {
    "eslint": "^8.57.0",
    "@typescript-eslint/eslint-plugin": "^7.18.0",
    "@typescript-eslint/parser": "^7.18.0",
    "typescript": "^6.0.3",
    "tsx": "^4.19.0",
    "@types/node": "^22.7.0"
  },
  "dependencies": {
    "axios": "^1.7.0",
    "moment": "^2.30.0",
    "qs": "^6.12.0",
    "sprintf-js": "^1.1.3"
  }
}

2.2.2. El archivo tsconfig.json

Este archivo configura el compilador de TypeScript. El modo estricto está habilitado: es la configuración recomendada, ya que permite a TypeScript detectar el mayor número posible de errores durante la compilación.

{
  "compilerOptions": {
    "target": "ES2023",
    "lib": ["ESNext"],
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    "strict": true,
    "types": ["node"],
    "noEmit": true
  },
  "include": ["**/*.ts"]
}
Importante: A partir de TypeScript 6.0, la "types" línea: ["node"] es esencial: sin ella, TypeScript ya no reconoce automáticamente los objetos globales de Node.js como `console` o `process`, a diferencia de las versiones anteriores a la 6.0.
Nota: Aquí no hay nada que instalar. Como en todas las demás carpetas del árbol de directorios, las dependencias de `typescript-fundamentals/`—y de todos los scripts de este curso—ya se instalaron con un único comando `npm install`, ejecutado una sola vez en la raíz de `typescript-nestjs-course-scripts/` (véase la introducción de este documento): lo demuestra la node_modules carpeta ya presente en la raíz en la captura de pantalla anterior, gracias a los [npm workspaces]. Por lo tanto, el proyecto está listo para usarse en cuanto se descarga.

Si aún no ha descargado la estructura de directorios, o si necesita reinstalar sus dependencias, aquí está el recordatorio del único comando que debe ejecutarse (una sola vez) en el directorio raíz; instalará todos los módulos de Node.js necesarios para todos los scripts del curso:

npm install

Los siguientes comandos se ingresan en una terminal de VSCode con el directorio establecido en [typescript-fundamentals].

Image

2.3. Primer script

Creemos un archivo llamado tests/test-01.ts:

// un primer programa TypeScript
console.log("hello world!");

Ejecútelo desde la terminal, en el directorio raíz del proyecto:

npx tsx tests/test-01.ts

Resultado de la ejecución:

hello world!

2.4. Segundo script: verificación de tipos

Creemos un segundo archivo, tests/test-02.ts, con una variable tipada explícitamente:

'use strict'
let x: number = 4;
console.log("x=", x);
npx tsx tests/test-02.ts

Resultado de la ejecución:

x= 4

Ahora intentemos asignar una cadena a esta variable declarada como número:

x = "abc";

Sin siquiera ejecutar el script, VSCode resalta de inmediato la línea en rojo y el comando de verificación de tipos falla:

npx tsc --noEmit

Resultado de la ejecución:

tests/test-02.ts(4,1): error TS2322: Type 'string' is not assignable to type 'number'.

Esta es la ventaja clave de TypeScript sobre JavaScript: toda una categoría de errores (mezclas accidentales de tipos) se detecta antes de la ejecución, directamente en el editor, en lugar de descubrirse cuando el código falla en producción.

2.5. ESLint

[ESLint] es una herramienta que verifica que el código respete un conjunto de reglas de estilo y buenas prácticas (variables no utilizadas, comparaciones sospechosas, etc.). El archivo de configuración .eslintrc.cjs (la extensión .cjs, y no .js, es necesaria porque package.json declara "type": "module") usa el analizador @typescript-eslint, que entiende la sintaxis de TypeScript (tipos, interfaces, campos privados #x...):

module.exports = {
  root: true,
  env: { node: true, es2024: true },
  extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
  parser: "@typescript-eslint/parser",
  plugins: ["@typescript-eslint"],
  parserOptions: { ecmaVersion: "latest", sourceType: "module" }
};

Luego analizamos todo el proyecto con:

npx eslint . --ext .ts

2.6. ESLint en VSCode

La extensión de VSCode, llamada [ESLint] (que se instala desde la pestaña Extensiones), muestra las advertencias de ESLint directamente en el editor en tiempo real, sin tener que ejecutar el comando manualmente cada vez.

Ya contamos con un entorno de trabajo completo. El siguiente capítulo trata los fundamentos del lenguaje TypeScript.