이 글은 블로그 UI를 확인하기 위한 샘플 글입니다. 특정 제품의 코드가 아닌 일반적인 예제를 사용했습니다.
TypeScript의 타입은 컴파일 시점에만 존재합니다. API 응답, 설정 파일, 사용자 입력처럼 프로그램 밖에서 들어오는 데이터는 선언한 타입과 다를 수 있습니다. 이런 데이터는 들어오는 경계에서 한 번 검증하고, 그 뒤의 코드는 검증된 타입을 믿고 사용하는 구성이 단순합니다.
타입과 런타임 검증의 차이
interface Profile {
name: string;
age: number;
}
// 타입 단언은 값을 검사하지 않는다.
const profile = JSON.parse(raw) as Profile;
위 코드는 컴파일은 되지만 age가 문자열로 들어와도 알아차리지 못합니다.
경계에서 검증하기
스키마 라이브러리를 사용하면 검증과 타입 정의를 한 곳에 둘 수 있습니다.
import { z } from "zod";
const ProfileSchema = z.object({
name: z.string().min(1),
age: z.number().int().nonnegative(),
});
type Profile = z.infer<typeof ProfileSchema>;
export function parseProfile(raw: unknown): Profile {
return ProfileSchema.parse(raw);
}
실패를 다루는 방법
검증 실패를 빈 값으로 바꾸면 문제가 뒤늦게 드러납니다. 호출자가 처리할 수 있는 실패라면 결과 타입으로 전달하고, 그렇지 않다면 원인을 담은 오류를 그대로 전파합니다.
내부 코드는 단순하게
경계를 통과한 데이터는 이미 검증되었으므로, 내부 함수마다 같은 검사를 반복하지 않아도 됩니다.
| 위치 | 할 일 |
|---|---|
| 외부 경계 | 형식과 도메인 제약을 검증한다 |
| 내부 로직 | 검증된 타입을 그대로 사용한다 |
| 출력 경계 | 외부 계약에 맞게 변환한다 |
검증을 한 곳에 모으면, 데이터 형식이 바뀌었을 때 고칠 곳도 한 곳으로 줄어듭니다.
