환경 변수에 타입 지정하기

process.env의 문제

타입이 지정된 Env 인터페이스 선언하기

interface Env {
  PORT: number;
  NODE_ENV: "development" | "production";
  DATABASE_URL: string;
  DEBUG?: boolean; // optional
}

원시 값 읽기

const rawPort = process.env.PORT; // string | undefined
const rawEnv = process.env.NODE_ENV; // string | undefined

필수 변수와 선택적 변수

function required(name: string): string {
  const v = process.env[name];
  if (v === undefined) throw new Error("Missing env: " + name);
  return v;
}

숫자 파싱하기

function num(name: string): number {
  const n = Number(required(name));
  if (Number.isNaN(n)) throw new Error(name + " is not a number");
  return n;
}

불리언 파싱하기

function bool(name: string, def = false): boolean {
  const v = process.env[name];
  if (v === undefined) return def;
  return v === "true" || v === "1";
}

타입이 지정된 Config 만들기

const env: Env = {
  PORT: num("PORT"),
  NODE_ENV: required("NODE_ENV") as Env["NODE_ENV"],
  DATABASE_URL: required("DATABASE_URL"),
  DEBUG: bool("DEBUG"),
};

문자열 유니온 제한하기

function oneOf<T extends string>(name: string, allowed: readonly T[]): T {
  const v = required(name) as T;
  if (!allowed.includes(v)) throw new Error(name + " invalid");
  return v;
}

접근 중앙 집중화하기

export const config = env;
// elsewhere: import { config } from "./config";

ProcessEnv 보강(선택 사항)

// declare global { namespace NodeJS { interface ProcessEnv { PORT: string } } }

타입이 지정된 Config 객체가 더 나은 이유

빠른 확인

복습