Como criar e organizar módulos no Node.js

À medida que um projeto Node.js cresce, manter todo o código em um único arquivo se torna inviável. Para resolver esse problema, o Node permite dividir o código em módulos.

O Problema

Em aplicações maiores, misturar rotas, regras de negócio e acesso a banco em um único arquivo gera:

• Código difícil de manter
• Dificuldade de reutilização
• Maior chance de erros

Organizar o projeto em módulos ajuda a manter o código mais limpo e reutilizável.

A Solução

No Node.js podemos separar funcionalidades em arquivos diferentes e exportar funções para serem utilizadas em outras partes do sistema.

Criando um módulo

Arquivo:

calculadora.js

function somar(a, b) {
    return a + b;
}
 
function subtrair(a, b) {
    return a - b;
}
 
module.exports = {
    somar,
    subtrair
};

Utilizando o módulo

Arquivo principal:

const calc = require('./calculadora');
 
console.log(calc.somar(10, 5));
console.log(calc.subtrair(10, 5));

Dessa forma, cada arquivo possui uma responsabilidade específica dentro da aplicação.

Estrutura comum de projetos Node.js

projeto/
 ├ controllers/
 ├ models/
 ├ routes/
 ├ services/
 ├ server.js

Essa organização ajuda a separar responsabilidades dentro do projeto.

Conclusão

Utilizar módulos é essencial para manter projetos Node.js organizados. Essa abordagem facilita manutenção, reutilização de código e evolução do sistema.