NestJS biedt het @nestjs/config pakket voor het beheren van configuratie en omgevingsvariabelen op een gestructureerde, type-safe, injectable manier. Het laadt .env bestanden, valideert config, en maakt waarden beschikbaar in de hele app via de injectable ConfigService.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() laadt omgevingsvariabelen (uit .env + de process environment) en — cruciaal — kan ze valideren met een schema (Joi), zodat ontbrekende of ongeldige config de app bij startup doet crashen met een duidelijke fout in plaats van mystereus op runtime te falen.
@Injectable()
export class DatabaseService {
constructor(private configService: ConfigService) {} // inject ConfigService
connect() {
const url = this.configService.get<string>("DATABASE_URL");
const port = this.configService.get<number>("PORT", 3000); // with a default
}
}
In plaats van process.env rechtstreeks overal uit te lezen, inject je ConfigService en roep je get() aan — type-safe, testable, en gecentraliseerd.
// config/database.config.ts — group related config with registerAs
export default registerAs("database", () => ({
host: process.env.DB_HOST,
port: parseInt(process.env.DB_PORT, 10),
}));
// load it: ConfigModule.forRoot({ load: [databaseConfig] })
// access it: configService.get("database.host")
Namespaceing groepeert gerelateerde instellingen en houdt config georganiseerd naarmate het groeit.
✗ process.env scattered everywhere → hard to test, no validation, stringly-typed
✓ ConfigService → injectable (mockable in tests), validated at startup, typed,
centralized — the structured NestJS way
✓ Keep secrets in .env (GITIGNORED) — commit a .env.example documenting required vars
✓ In production, inject config via the platform's env vars / secret manager
✓ Validate at startup so misconfiguration fails immediately with a clear message
Juist configuratiebeheer is essentieel voor elke echte applicatie — het veilig en flexibel omgaan met database-URL's, API-sleutels, poorten, secrets en feature flags over omgevingen heen (dev, staging, production).
De @nestjs/config van NestJS biedt de gestructureerde, idiomatische manier om dit te doen, en het begrijpen ervan is belangrijke dagelijkse kennis.
De belangrijkste voordelen ten opzichte van direct process.env uitlezen zijn significant: de injectable ConfigService maakt config testable (mockable in tests) en gecentraliseerd; validatie bij startup (met een Joi schema) vangt ontbrekende of misvormde configuratie onmiddellijk op met een duidelijke fout in plaats van als een verwarrende runtime failure diep in een request; en namespacing houdt groeiende config georganiseerd.
Gecombineerd met de best practice voor veiligheid om secrets in gitignored .env bestanden te houden (en een gecommitted .env.example), geef je jezelf veilige, portable, gevalideerde configuratie.
Weten hoe je ConfigModule instelt, ConfigService inject en gebruikt, en config valideert, is fundamenteel voor het bouwen van production-ready NestJS applicaties en weerspiegelt professionele back-end praktijk.