🚀 Módulos Nativos no Node.js: Entendendo
__filename e __dirname
Se você já começou a trabalhar com Node.js, provavelmente já viu
duas variáveis que parecem simples, mas são extremamente
poderosas: __filename e __dirname.
Bora entender isso de forma prática? 👇
📍 O que é __filename?
Essa variável global retorna o caminho completo do arquivo que está sendo executado. Ou seja, não é só o nome do arquivo, mas todo o caminho absoluto até ele.
👉 Ela representa exatamente o arquivo atual em execução, incluindo seu diretório completo.
💡 Na prática: ideal para logs, debugging e rastreamento de arquivos.
📂 E o __dirname?
Já o __dirname retorna o
caminho completo da pasta onde o arquivo está
localizado.
👉 Essa variável representa o diretório atual do arquivo em execução.
💡 Ou seja, enquanto __filename aponta para o
arquivo, o __dirname aponta para a pasta.
⚙️ Por que isso é importante?
Essas variáveis são essenciais quando você precisa trabalhar com arquivos no sistema operacional.
Elas ajudam a evitar problemas com caminhos relativos, garantindo que seu código funcione corretamente em qualquer ambiente.
🔥 Exemplos de uso
- ✔ Localizar arquivos com precisão
- ✔ Criar caminhos absolutos
- ✔ Garantir compatibilidade entre sistemas
- ✔ Melhorar a organização do projeto
🧠 Resumo rápido
-
📄
__filename→ caminho completo do arquivo -
📁
__dirname→ caminho completo do diretório
Simples, mas indispensável no dia a dia de quem trabalha com Node.js.
💡 Conclusão
Dominar essas duas variáveis é um passo fundamental para evoluir no backend com Node.js. Elas parecem detalhes, mas fazem toda a diferença quando o projeto cresce e começa a lidar com múltiplos arquivos e estruturas.