1. Introducción
El PDF del documento está |AQUÍ|.
Los códigos del documento están |AQUÍ|.
Este documento es un producto de Claude, la IA de Anthropic. Su propósito es transponer el documento: [Introduction to the Python 3 Language and the Flask Web Framework Through Examples] de dos maneras:
- el lenguaje Python 3 se reemplaza por el lenguaje TypeScript 6;
- el framework web Flask de Python se reemplaza por el framework web NestJS;
Claude de Anthropic hizo la mayor parte del trabajo (90 %):
- generación del código. Se partió del código ya escrito para el curso “Introducción al lenguaje ECMASCRIPT 6 mediante ejemplos”. Luego le pedí a Claude que ampliara los scripts del curso para incluir la gestión de bases de datos y que después construyera un servicio web con el framework NestJS;
- generación del curso en formato ODT. También aquí se partió del ODT del curso “Introducción al lenguaje ECMASCRIPT 6 mediante ejemplos”. Luego le pedí a Claude que incluyera todos los scripts nuevos que había creado y que les agregara comentarios.
Mi trabajo consistió en dos cosas:
- probar el código;
- revisar el documento ODT. En particular, agregué capturas de pantalla para ayudar al lector;
Serge Tahé, septiembre de 2026
==
El lenguaje ECMAScript ha evolucionado de manera significativa desde 2019: ECMAScript ha pasado por las ediciones de 2020 a 2026, y un lenguaje complementario, [TypeScript], se ha consolidado como la forma más segura de escribir JavaScript a gran escala. Esta reescritura sigue de cerca la estructura y el enfoque pedagógico del documento original “Introducción al lenguaje ECMASCRIPT 6 mediante ejemplos”—un script, su código, su explicación línea por línea y su ejecución—, pero:
- todos los scripts se escriben ahora en [TypeScript] en lugar de JavaScript puro;
- las explicaciones cubren no solo la sintaxis del lenguaje, sino también sus tipos de datos y las diferencias con JavaScript;
- se han agregado nuevos capítulos para cubrir las novedades introducidas entre 2020 y 2026: encadenamiento opcional, clases con campos privados,
awaitde nivel superior, Object.groupBy, Array.fromAsync y las últimas incorporaciones de ECMAScript 2026 (Math.sumPrecise, Iterator.concat, Error.isError...); - un capítulo está dedicado a [Temporal], el sucesor moderno del objeto Date;
- las capturas de pantalla de ejecución en VSCode del documento original se han reemplazado por la salida real y verificada de cada script, obtenida con tsx en Node.js 26.
Al igual que el documento original, este se refiere a un servidor de cálculo de impuestos escrito en PHP 7 (véase el curso “Introducción al lenguaje PHP7 mediante ejemplos”). Los últimos capítulos construyen, en TypeScript, un cliente para este servidor: primero una aplicación de consola, estructurada en capas con [UI, business, dao], y luego un cliente que se ejecuta en un navegador con [webpack].
Este documento requiere una lectura activa: para entender un script, hay que leer su código, sus comentarios y el resultado real de su ejecución.
1.1. Público objetivo y requisitos previos
Este documento está dirigido a principiantes en TypeScript que ya conocen los fundamentos de la programación (variables, bucles, funciones, estructuras condicionales) en otro lenguaje. No se requieren conocimientos previos de JavaScript ni de TypeScript.
1.2. Organización del proyecto de ejemplo
Todos los scripts presentados en este documento pertenecen a un único proyecto de VSCode—la carpeta typescript-fundamentals/ dentro de la estructura de directorios completa que se describe a continuación—, organizado en una carpeta por capítulo (basics, arrays, objects, strings, regexp, functions, exceptions, modules, async, http, classes, whats-new, ecmascript-2026, temporal, tax client). Cada script es un archivo .ts que puede ejecutarse directamente con el siguiente comando desde la raíz del proyecto:
A partir de los capítulos sobre bases de datos y NestJS, este proyecto ya no se limita a la carpeta mencionada arriba: forma parte ahora de una estructura de directorios única y más amplia que incluye todos los scripts presentados en este documento—fundamentos de TypeScript, acceso a bases de datos, miniproyectos de NestJS y casos de estudio. Es esta estructura de directorios completa la que el lector descarga, y un único comando **npm install , ejecutado desde su directorio raíz, instala todo de una sola vez, gracias a los [npm workspaces]**:
typescript-nestjs-course-scripts/
├── package.json
├── README.md
├── typescript-fundamentals/
│ ├── basics/ arrays/ objects/ strings/ regexp/ functions/
│ ├── exceptions/ modules/ async/ http/ classes/
│ └── whats-new/ ecmascript-2026/ temporal/ tax client/
├── typescript-databases/
│ ├── sql/
│ └── databases/ (mysql/ typeorm/ prisma/)
├── nestjs-course/
│ ├── hello-nest/
│ ├── actions-response/
│ ├── actions-model/
│ └── data-access/ (native-driver/ typeorm/ prisma/)
└── nestjs-case-study/
├── src/ (actions/ config/ entities/ filters/ model/ responses/ session/ utilities/)
└── views/
La finalidad de cada una de estas carpetas:
- typescript-fundamentals/ — los scripts de los capítulos del lenguaje (el descrito arriba: basics, arrays, objects, functions, classes, async, exceptions, modules, novedades de ECMAScript, [Temporal], seguidos del cliente del servidor de cálculo de impuestos);
- typescript-databases/ — los tres capítulos sobre acceso a bases de datos: el controlador nativo mysql2, el ORM TypeORM y el ORM Prisma;
- nestjs-course/ — los miniproyectos de NestJS de los capítulos sobre el framework: hello-nest (primer proyecto), actions-response, actions-model y los fragmentos de data-access que ilustran NestJS combinado con el controlador nativo, TypeORM y Prisma;
- nestjs-case-study/ — el proyecto completo del capítulo “Caso de estudio”: la migración a NestJS del servidor de cálculo de impuestos en PHP.
El archivo README.md del directorio raíz sigue esta estructura; como se indicó arriba, cada subcarpeta contiene además su propio archivo README.md, con sus instrucciones de ejecución específicas.