Skip to content

1. Introdução

O PDF do documento está |AQUI|.

Os códigos do documento estão |AQUI|.

Este documento é um produto do Claude, a IA da Anthropic. Seu objetivo é transpor o documento [Introduction to the Python 3 Language and the Flask Web Framework Through Examples] de duas formas:

  • a linguagem Python 3 é substituída pela linguagem TypeScript 6;
  • o framework web Flask em Python é substituído pelo framework web NestJS;

O Claude, da Anthropic, fez a maior parte do trabalho (90%):

Meu trabalho consistiu em duas coisas:

  • testar o código;
  • revisar o documento ODT. Em particular, acrescentei capturas de tela para ajudar o leitor;

Serge Tahé, setembro de 2026

==

A linguagem ECMAScript evoluiu significativamente desde 2019: o ECMAScript passou pelas edições de 2020 a 2026, e uma linguagem complementar, [TypeScript], firmou-se como a forma mais segura de escrever JavaScript em grande escala. Esta reescrita segue de perto a estrutura e a abordagem pedagógica do documento original “Introdução à linguagem ECMASCRIPT 6 por meio de exemplos”—um script, seu código, sua explicação linha por linha e sua execução—mas:

  • todos os scripts agora são escritos em [TypeScript] em vez de JavaScript puro;
  • as explicações abordam não só a sintaxe da linguagem, mas também seus tipos de dados e as diferenças em relação ao JavaScript;
  • foram acrescentados novos capítulos para cobrir os recursos introduzidos entre 2020 e 2026: encadeamento opcional, classes com campos privados, await no nível superior, Object.groupBy, Array.fromAsync e as últimas adições do ECMAScript 2026 (Math.sumPrecise, Iterator.concat, Error.isError...);
  • um capítulo é dedicado ao [Temporal], o sucessor moderno do objeto Date;
  • as capturas de tela da execução no VSCode do documento original foram substituídas pela saída real e verificada de cada script, usando tsx no Node.js 26.

Como o documento original, este se refere a um servidor de cálculo de imposto escrito em PHP 7 (veja o curso “Introdução à linguagem PHP7 por meio de exemplos”). Os capítulos finais constroem, em TypeScript, um cliente para esse servidor—primeiro uma aplicação de console, estruturada em camadas com [UI, business, dao], e depois um cliente executado em um navegador com [webpack].

Este documento exige leitura ativa: para entender um script, é preciso ler seu código, seus comentários e o resultado real de sua execução.

1.1. Público-alvo e pré-requisitos

Este documento destina-se a iniciantes em TypeScript que já conhecem os fundamentos da programação (variáveis, laços, funções, estruturas condicionais) em outra linguagem. Não é necessário nenhum conhecimento prévio de JavaScript ou TypeScript.

1.2. Organização do projeto de exemplo

Todos os scripts apresentados neste documento pertencem a um único projeto do VSCode—a pasta typescript-fundamentals/ da estrutura de diretórios completa descrita abaixo—organizado em uma pasta por capítulo (basics, arrays, objects, strings, regexp, functions, exceptions, modules, async, http, classes, whats-new, ecmascript-2026, temporal, tax client). Cada script é um arquivo .ts que pode ser executado diretamente com o seguinte comando, a partir da raiz do projeto:

npx tsx path/to/the/script.ts
Dica: Os arquivos README.md de cada pasta do projeto trazem um resumo condensado do conteúdo didático deste documento—eles podem servir como referência rápida depois que você tiver lido o documento.

A partir dos capítulos sobre bancos de dados e NestJS, este projeto deixa de se limitar à pasta mencionada acima: ele passa a fazer parte de uma única estrutura de diretórios mais ampla, que inclui todos os scripts apresentados neste documento—fundamentos do TypeScript, acesso a bancos de dados, miniprojetos NestJS e estudos de caso. É essa estrutura de diretórios completa que o leitor baixa, e um único comando **npm install , executado a partir de sua raiz, instala tudo de uma só vez, graças aos [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/

A finalidade de cada uma dessas pastas:

  • typescript-fundamentals/ — os scripts dos capítulos sobre a linguagem (o descrito acima: basics, arrays, objects, functions, classes, async, exceptions, modules, novidades do ECMAScript, [Temporal], seguidos do cliente do servidor de cálculo de imposto);
  • typescript-databases/ — os três capítulos sobre acesso a bancos de dados: o driver nativo mysql2, o ORM TypeORM e o ORM Prisma;
  • nestjs-course/ — os miniprojetos NestJS dos capítulos sobre o framework: hello-nest (primeiro projeto), actions-response, actions-model e os trechos data-access que ilustram o NestJS combinado com o driver nativo, o TypeORM e o Prisma;
  • nestjs-case-study/ — o projeto completo do capítulo “Estudo de caso”: a portabilidade para o NestJS do servidor PHP de cálculo de imposto.

O arquivo README.md na raiz segue essa estrutura; como observado acima, cada subpasta também contém seu próprio arquivo README.md, com suas instruções específicas de execução.