TypeScript Academy · Les

Omgevingsvariabelen en configuratietypen

Voorzie process.env van een type met een gevalideerde configuratiemodule.

Les 4 van 413 stappen

Omgevingsvariabelen en configuratietypen is een gratis TypeScript Academy-les op CoddyKit. Dit is les 4 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject TypeScript Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus TypeScript Academy bevat in totaal 4 lessen.

Welkom

Door process.env te typen voorkom je fouten tijdens uitvoering door ontbrekende of verkeerd getypeerde omgevingsvariabelen.

Het probleem

Waarden van process.env hebben altijd het type string | undefined. Als je ze zonder controle benadert, ontstaan er fouten.
const port = process.env.PORT; // string | undefined
// server.listen(port); // could be undefined!

Moduleaanvulling voor process.env

Breid ProcessEnv uit in een globaal declaratiebestand om bekende omgevingsvariabelen een type te geven.
declare global {
  namespace NodeJS {
    interface ProcessEnv {
      PORT: string;
      DATABASE_URL: string;
      NODE_ENV: 'development' | 'staging' | 'production';
    }
  }
}

Patroon voor configuratiemodule

Maak een getypeerde configuratiemodule die omgevingsvariabelen valideert en exporteert.
function requireEnv(key: string): string {
  const val = process.env[key];
  if (!val) throw new Error(`Missing env var: ${key}`);
  return val;
}
export const config = {
  port: parseInt(requireEnv('PORT')),
  dbUrl: requireEnv('DATABASE_URL'),
};

Zod voor validatie van omgevingsvariabelen

Valideer omgevingsvariabelen bij het opstarten met Zod voor uitgebreide controle tijdens uitvoering.
import { z } from 'zod';
const envSchema = z.object({
  PORT: z.string().transform(Number),
  DATABASE_URL: z.string().url(),
  NODE_ENV: z.enum(['development', 'production']),
});
export const env = envSchema.parse(process.env);

dotenv met TypeScript

Laad .env-bestanden met dotenv voordat je process.env benadert.
import 'dotenv/config';
// Or:
import dotenv from 'dotenv';
dotenv.config();

Strikte toegang tot omgevingsvariabelen

Gebruik in applicatiecode altijd de configuratiemodule voor toegang tot omgevingsvariabelen, nooit rechtstreeks process.env.

Configuratie voor verschillende omgevingen

Gebruik NODE_ENV om omgevingsspecifieke configuratiebestanden te laden.
const envFile = `.env.${process.env.NODE_ENV ?? 'development'}`;
dotenv.config({ path: envFile });

Geheimen maskeren in logregistratie

Registreer nooit configuratieobjecten met geheimen in logboeken. Maskeer gevoelige velden.
console.log({ ...config, dbPassword: '***', apiKey: '***' });

Typeveilige functievlaggen

Geef omgevingsvariabelen voor functievlaggen een type.
const flags = {
  enableBeta: process.env.ENABLE_BETA === 'true',
  logLevel: (process.env.LOG_LEVEL ?? 'info') as 'debug' | 'info' | 'warn',
};

Testen met omgevingsvariabelen

Gebruik een .env.test-bestand en laad het tijdens het instellen van tests.
// tests/setup.ts
process.env.DATABASE_URL = 'sqlite:///:memory:';
process.env.NODE_ENV = 'test';

Snelle controle

Wat is het TypeScript-type van `process.env.PORT` zonder enige moduleaanvulling?

Samenvatting

Breid ProcessEnv uit via moduleaanvulling of gebruik een Zod-configuratiemodule om omgevingsvariabelen bij het opstarten een type te geven en te valideren. Gebruik altijd een configuratiemodule voor toegang tot omgevingsvariabelen, nooit rechtstreeks.
Gratis beginnen

Leer TypeScript met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen
101
Lessen
352

Veelgestelde vragen

Is de les “Omgevingsvariabelen en configuratietypen” gratis?

Ja — de volledige tekst van “Omgevingsvariabelen en configuratietypen” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus TypeScript Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus TypeScript Academy bevat in totaal 4 lessen.

Wat leer ik in “Omgevingsvariabelen en configuratietypen”?

Voorzie process.env van een type met een gevalideerde configuratiemodule. Je oefent met TypeScript Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met TypeScript Academy te beginnen?

Ervaring vooraf is niet nodig. TypeScript Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 4 van 4.

Hoe lang duurt de les “Omgevingsvariabelen en configuratietypen”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over TypeScript Academy?

Ja. Elke les over TypeScript Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

  1. TypeScript instellen met Node.js
  2. Express Request en Response typeren
  3. Getypeerde middleware en error handlers
  4. Omgevingsvariabelen en configuratietypen
← Terug naar TypeScript Academy