API

dotenv.load(options?)

Lädt .env und optional .env.{env}. Befüllt process.env.

1 await dotenv.load();
2 await dotenv.load({ env: 'stage' });

Option	Typ	Beschreibung
`env`	`string`	Environment-Name für `.env.{env}` – Fallback: `process.env.NODE_ENV`
`override`	`boolean`	Überschreibt bestehende `process.env` Werte (Standard: `false`)

dotenv.get(key, fallback?)

Gibt den Wert einer Variable zurück.

1 dotenv.get('PORT')           // '3000' | null
2 dotenv.get('PORT', '8080')   // '3000' oder '8080' als Fallback
3 dotenv.get('MISSING', '42')  // '42'

dotenv.has(key)

Prüft ob eine Variable gesetzt ist.

1 dotenv.has('PORT')     // → true
2 dotenv.has('MISSING')  // → false

dotenv.getAll()

Gibt einen Snapshot von process.env zurück (Kopie, keine Referenz).

1 dotenv.getAll();
2 // → { PORT: '3000', NODE_ENV: 'stage', ... }

dotenv.require(key)

Gibt den Wert zurück oder wirft einen Error wenn die Variable fehlt.

1 dotenv.require('TURN_SECRET')   // → 'abc123' oder Error

Nützlich für kritische Variablen die beim Start vorhanden sein müssen.

dotenv.optional(key, fallback)

Setzt einen Fallback-Wert wenn die Variable nicht gesetzt ist.

1 dotenv.optional('LOG_LEVEL', 'info');

dotenv.loaded

true nach dem ersten erfolgreichen load() Aufruf.

1 dotenv.loaded  // → true | false

dotenv.files

Array der zuletzt geladenen Dateipfade.

1 dotenv.files  // → ['.env', '.env.stage']

Event: `dotenv:loaded`

Wird nach load() emittiert.

1 // Payload:
2 {
3     env:      'stage',
4     files:    ['.env', '.env.stage'],
5     override: false
6 }

1	dotenv.get('PORT') // '3000' \| null
2	dotenv.get('PORT', '8080') // '3000' oder '8080' als Fallback
3	dotenv.get('MISSING', '42') // '42'

1	dotenv.has('PORT') // → true
2	dotenv.has('MISSING') // → false

1	dotenv.getAll();
2	// → { PORT: '3000', NODE_ENV: 'stage', ... }

1	// Payload:
2	{
3	env: 'stage',
4	files: ['.env', '.env.stage'],
5	override: false
6	}