ตัวแปรสภาพแวดล้อมและการระบุชนิดการกำหนดค่า

ยินดีต้อนรับ

ปัญหา

const port = process.env.PORT; // string | undefined
// server.listen(port); // could be undefined!

การเพิ่มส่วนขยายโมดูลสำหรับ process.env

declare global {
  namespace NodeJS {
    interface ProcessEnv {
      PORT: string;
      DATABASE_URL: string;
      NODE_ENV: 'development' | 'staging' | 'production';
    }
  }
}

รูปแบบโมดูลการกำหนดค่า

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

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 กับ TypeScript

import 'dotenv/config';
// Or:
import dotenv from 'dotenv';
dotenv.config();

การเข้าถึง env อย่างเคร่งครัด

การกำหนดค่าสำหรับสภาพแวดล้อมที่แตกต่างกัน

const envFile = `.env.${process.env.NODE_ENV ?? 'development'}`;
dotenv.config({ path: envFile });

การปกปิดข้อมูลลับในบันทึก

console.log({ ...config, dbPassword: '***', apiKey: '***' });

แฟล็กคุณลักษณะที่ปลอดภัยด้านชนิด

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

การทดสอบด้วยตัวแปรสภาพแวดล้อม

// tests/setup.ts
process.env.DATABASE_URL = 'sqlite:///:memory:';
process.env.NODE_ENV = 'test';

ตรวจสอบสั้น ๆ

สรุปทบทวน