O TypeScript adiciona tipagem estática ao código JavaScript, ajudando a reduzir comportamentos imprevisíveis e bugs. No passado, o código TypeScript não rodava diretamente no Node.js. A maneira padrão era primeiro compilá-lo para JavaScript usando a ferramenta CLI do TypeScript (tsc) e depois executar o código resultante.

Com o lançamento da versão 22.6 do Node.js, o runtime adicionou suporte experimental leve para TypeScript, utilizando um método conhecido como remoção de tipos.

Um runner TypeScript é qualquer programa que executa diretamente o código TypeScript. Runners de TypeScript lidam com dois passos de desenvolvimento ao mesmo tempo, tornando o processo mais rápido. Vamos explorar três maneiras de rodar TypeScript no Node.js:

1. Usando a remoção de tipos nativa do Node.js
2. Usando tsx
3. Usando ts-node

Remoção de tipos no Node.js

Na versão 22.6, o Node.js lançou a flag --experimental-strip-types. Quando usada, transforma um arquivo TypeScript em JavaScript antes de executá-lo. O Node.js não faz verificação de tipos, deixando essa tarefa para o desenvolvedor.

Desvantagens do uso da remoção de tipos do Node.js

Algumas desvantagens incluem:

• Funcionalidade ainda experimental e não recomendada para produção.
• Não faz verificação de tipos, apenas remove e executa o código.
• Ignora o arquivo tsconfig.json e não usa instruções personalizadas.

Módulo ts-node

O ts-node é um módulo npm de terceiros usado para rodar TypeScript diretamente no Node.js. Ele oferece suporte completo ao TypeScript, ao contrário da remoção de tipos do Node.js.

Como usar ts-node

Para usar ts-node, instale-o como uma dependência de desenvolvimento junto com o TypeScript. Execute o arquivo TypeScript no Node.js usando o comando:

npx ts-node index.js

Pode-se usar ts-node na produção?

O ts-node pode ser usado em produção, mas adiciona um overhead desnecessário. É melhor transpilar o código para JavaScript antes.

Módulo tsx

O tsx é um pacote npm que usa o Node.js para executar código TypeScript. Ele tenta ser intuitivo e amigável para iniciantes. O tsx não suporta verificação de tipos, mas oferece um REPL TypeScript.

Como usar tsx

Instale o tsx como uma dependência de desenvolvimento e use o comando:

npx tsx index.js

Comparando runners TypeScript

Recursos	Remoção de tipos Node.js	ts-node	tsx
Verificação de tipos	❌	✅	❌
Suporte completo ao TypeScript	Experimental	✅	✅

Conclusão

Este artigo mostrou diferentes maneiras de executar TypeScript diretamente no Node.js, destacando as vantagens e desvantagens de cada método.