Como configurar Typescript em um projeto NodeJs

Para configurar o TypeScript em um projeto Node.js, você precisará seguir alguns passos básicos para configurar o ambiente e o arquivo de configuração para o TypeScript. A seguir vamos mostrar passo a passo a configuração, para prosseguir é necessário que você já possua o NodeJS devidamente instalado assim como o NPM:

Passo a passo da configuração do typescript

1 – Instalação do TypeScript

Primeiro, você precisa instalar o TypeScript globalmente ou localmente no seu projeto. Recomenda-se a instalação local para manter a consistência de versões em diferentes projetos.

npm install typescript --save-dev
ShellScript

2 – Inicializar o arquivo de configuração TypeScript

Você pode inicializar um arquivo de configuração TypeScript chamado tsconfig.json no seu projeto usando o seguinte comando:

npx tsc --init
ShellScript

Isso criará um arquivo tsconfig.json com configurações padrão que você pode ajustar conforme necessário.

3 – Configurar o arquivo tsconfig.json

Abra o arquivo tsconfig.json e ajuste conforme suas necessidades. Aqui estão algumas configurações comuns:

{
  "compilerOptions": {
    "target": "ESNext",  // A versão do ECMAScript para a qual o código será transpilado
    "module": "CommonJS",  // Sistema de módulos (Node.js usa CommonJS)
    "outDir": "./dist",  // Diretório de saída para os arquivos transpilados
    "rootDir": "./src",  // Diretório de origem onde estão os arquivos TypeScript
    "strict": true,  // Habilita todas as verificações de tipo estritas
    "esModuleInterop": true,  // Habilita interoperabilidade com módulos ES6
    "skipLibCheck": true,  // Evita a verificação de bibliotecas de definições de tipo
    "forceConsistentCasingInFileNames": true,  // Garante consistência nos nomes de arquivos (sistema de arquivos não é case-sensitive)
    "resolveJsonModule": true  // Permite a importação de arquivos JSON como módulos
  },
  "include": [
    "src/**/*.ts"  // Padrão para incluir os arquivos TypeScript
  ],
  "exclude": [
    "node_modules"  // Diretório a ser excluído da transpilação
  ]
}
JSON

4 – Crie o código TypeScript

Crie seus arquivos TypeScript dentro do diretório especificado na configuração rootDir (por padrão, é ./src).

5 – Compilar o código TypeScript

Para compilar os arquivos TypeScript para JavaScript, use o comando:

npx tsc
ShellScript

Isso criará os arquivos JavaScript no diretório de saída especificado pela configuração outDir.

6 – Executar o código Node.js

Agora você pode executar seu código Node.js. Por exemplo:

node dist/seu_arquivo.js
ShellScript

Certifique-se de substituir “seu_arquivo.js” pelo nome do seu arquivo transpilado.

Com isso, você configurou o TypeScript em seu projeto Node.js e pode começar a escrever código TypeScript e aproveitar os benefícios da tipagem estática. Certifique-se de ajustar as configurações do tsconfig.json de acordo com as necessidades do seu projeto.

Para conhecer mais artigos sobre javascript

Mauricio Lima
Mauricio Lima

Bacharel em Ciência da Computação, profissional dedicado ao desenvolvimento de software e entusiasta da tecnologia.

Artigos: 65