Um arquivo com nomes e valores
Um arquivo dotenv define variáveis de ambiente como pares de nome e valor escritos em texto. O nome habitual é .env. Um mecanismo de carregamento lê o arquivo para disponibilizar suas definições à aplicação, por isso criar o arquivo no diretório não configura automaticamente um processo já em execução.
O Node.js tem suporte próprio ao formato, que também é usado por bibliotecas e frameworks. Cada implementação determina a sintaxe aceita e a forma de carregar o arquivo.
Números e booleanos chegam como texto
Este exemplo didático contém duas configurações que poderiam aparecer num arquivo .env:
LIMITE=10ATIVO=falseO interpretador do Node.js lê os valores como as strings '10' e 'false'. A aplicação precisa converter o limite para um número e validar o intervalo aceito. Para a opção de ativação, ela pode comparar o texto recebido com 'true', conforme os valores previstos na configuração.
Usar Boolean('false') em JavaScript produz true, porque a string contém caracteres. Essa conversão pode ativar uma função que você pretendia desativar. A aplicação também precisa tratar uma variável ausente ou com texto inesperado, em vez de aceitar qualquer conteúdo como configuração válida.
Sintaxe e credenciais
Não existe uma especificação universal para dotenv. Você precisa conferir o tratamento de aspas e a expansão de referências no carregador usado pelo projeto. Uma variável de teste sem credencial permite verificar o valor recebido sem exibir um segredo no terminal.
O formato guarda o conteúdo em texto e não oferece criptografia. Um arquivo .env.example pode documentar os nomes esperados, mas precisa conter valores demonstrativos próprios para compartilhamento. A extensão do arquivo não remove uma credencial escrita nele.
Dúvidas frequentes
Perguntas frequentes sobre dotenv
- Criar um arquivo .env já configura o processo?
- Não. O processo precisa de um mecanismo de carregamento, oferecido pelo runtime, pelo framework ou por uma biblioteca. Confira como a aplicação localiza e lê esse arquivo.
- O valor false vira um booleano no Node.js?
- Não. O interpretador do Node.js lê esse valor como o texto false. A aplicação precisa convertê-lo explicitamente quando espera um booleano.
- Posso usar a mesma sintaxe em qualquer leitor de dotenv?
- Não há uma especificação universal para o formato. Aspas e referências a outras variáveis podem receber tratamento diferente conforme a implementação utilizada.
Para continuar
Recursos relacionados
Documentação
Node.js: arquivos dotenv
Apresenta a sintaxe dotenv do Node.js e explica como os valores são lidos como textos.
Abrir recursoAplicação na formação
Developer Workspace
A configuração local precisa identificar como o projeto lê as variáveis definidas em arquivos de ambiente.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.