0Pricing
TypeScript Academy · Leçon

Variables d’environnement et typage de la configuration

Typez process.env avec un module de configuration validé

Variables d’environnement et typage de la configuration est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 4 leçons au total.

Bienvenue

Le typage de process.env évite les erreurs d'exécution dues à des variables d'environnement manquantes ou mal typées.

Le problème

Les valeurs de process.env sont toujours de type string | undefined. Leur accès sans vérification provoque des bogues.
const port = process.env.PORT; // string | undefined
// server.listen(port); // could be undefined!

Augmentation de module pour process.env

Étendez ProcessEnv dans un fichier de déclaration globale pour typer les variables env connues.
declare global {
  namespace NodeJS {
    interface ProcessEnv {
      PORT: string;
      DATABASE_URL: string;
      NODE_ENV: 'development' | 'staging' | 'production';
    }
  }
}

Modèle de module config

Créez un module config typé qui valide et exporte les variables env.
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 pour la validation de l'environnement

Validez les variables env au démarrage avec Zod pour effectuer une vérification complète à l'exécution.
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 avec TypeScript

Chargez les fichiers .env avec dotenv avant d'accéder à process.env.
import 'dotenv/config';
// Or:
import dotenv from 'dotenv';
dotenv.config();

Accès strict à env

Accédez toujours à env par l'intermédiaire du module config, jamais directement via process.env dans le code de l'application.

Configuration pour différents environnements

Utilisez NODE_ENV pour charger des fichiers de configuration propres à chaque environnement.
const envFile = `.env.${process.env.NODE_ENV ?? 'development'}`;
dotenv.config({ path: envFile });

Masquage des secrets dans les journaux

Ne journalisez jamais les objets config qui contiennent des secrets. Masquez les champs sensibles.
console.log({ ...config, dbPassword: '***', apiKey: '***' });

Indicateurs de fonctionnalité sûrs du point de vue des types

Typez les variables d'environnement des indicateurs de fonctionnalité.
const flags = {
  enableBeta: process.env.ENABLE_BETA === 'true',
  logLevel: (process.env.LOG_LEVEL ?? 'info') as 'debug' | 'info' | 'warn',
};

Tests avec des variables d'environnement

Utilisez un fichier .env.test et chargez-le lors de la configuration des tests.
// tests/setup.ts
process.env.DATABASE_URL = 'sqlite:///:memory:';
process.env.NODE_ENV = 'test';

Vérification rapide

Quel est le type TypeScript de `process.env.PORT` sans aucune augmentation ?

Récapitulatif

Étendez ProcessEnv via l'augmentation de module ou utilisez un module config avec Zod pour typer et valider les variables d'environnement au démarrage. Accédez toujours à env par l'intermédiaire d'un module config, jamais directement.

Questions Fréquemment Posées

La leçon « Variables d’environnement et typage de la configuration » est-elle gratuite ?

Oui — le texte complet de « Variables d’environnement et typage de la configuration » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Variables d’environnement et typage de la configuration » ?

Typez process.env avec un module de configuration validé Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Variables d’environnement et typage de la configuration » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Configurer TypeScript avec Node.js
  2. Typer les requêtes et réponses Express
  3. Intergiciels et gestionnaires d’erreurs typés
  4. Variables d’environnement et typage de la configuration
← Retour à TypeScript Academy