Anleitung

Hinweis

@xpulse/dotenv wird ausschließlich von @xpulse/config intern genutzt. Im eigenen App-Code brauchst du es nicht direkt importieren – @xpulse/config übernimmt das Laden automatisch.

Installation

1 npm install @xpulse/dotenv --registry=https://npm.xpulse.one

Quickstart

1 import dotenv from '@xpulse/dotenv';
2  
3 await dotenv.load();
4  
5 console.log(dotenv.get('PORT', '3000'));  // '3000'

Dateien laden

dotenv.load() lädt immer .env als Basis. Optional wird eine environment-spezifische Datei zusätzlich geladen:

1 // Lädt nur .env
2 await dotenv.load();
3  
4 // Lädt .env + .env.stage (stage überschreibt .env Werte)
5 await dotenv.load({ env: 'stage' });

Ist kein env angegeben, wird process.env.NODE_ENV als Fallback genutzt. Ist auch das nicht gesetzt, wird nur .env geladen.

Ladereihenfolge

1 1. .env          ← Basis
2 2. .env.{env}    ← Überschreibt Basis-Werte (falls vorhanden)

Events

Nach dem Laden wird dotenv:loaded via @xpulse/event emittiert – aber nur wenn dotenv.useEvent() vorher aufgerufen wurde:

1 import event from '@xpulse/event';
2 import dotenv from '@xpulse/dotenv';
3  
4 dotenv.useEvent(event);
5 await dotenv.load({ env: 'stage' });
6  
7 // → emittiert: dotenv:loaded { env: 'stage', files: ['.env', '.env.stage'], override: false }

Geladene Dateien

1 dotenv.loaded;         // → true
2 dotenv.files;          // → ['.env', '.env.stage']

1	import dotenv from '@xpulse/dotenv';
2
3	await dotenv.load();
4
5	console.log(dotenv.get('PORT', '3000')); // '3000'

1	// Lädt nur .env
2	await dotenv.load();
3
4	// Lädt .env + .env.stage (stage überschreibt .env Werte)
5	await dotenv.load({ env: 'stage' });

1	1. .env ← Basis
2	2. .env.{env} ← Überschreibt Basis-Werte (falls vorhanden)

1	import event from '@xpulse/event';
2	import dotenv from '@xpulse/dotenv';
3
4	dotenv.useEvent(event);
5	await dotenv.load({ env: 'stage' });
6
7	// → emittiert: dotenv:loaded { env: 'stage', files: ['.env', '.env.stage'], override: false }

1	dotenv.loaded; // → true
2	dotenv.files; // → ['.env', '.env.stage']