TypeScript interface, type 별칭, enum, 클래스 선언을 붙여넣으면 그 타입을 만족하는 예시 JSON을 만들어 줍니다. 리터럴 유니온, Record, Pick·Omit·Partial 같은 유틸리티 타입, extends로 이어진 인터페이스까지 따라가며 값을 채웁니다.
프런트엔드에서 API 연동 전에 MSW·json-server 목 데이터를 준비하거나, Storybook 스토리의 props를 만들거나, 백엔드에 "이런 모양으로 보내 달라"고 요청할 샘플이 필요할 때 쓰면 됩니다.
types.ts 같은 파일의 타입 선언을 붙여넣습니다. export, import, 함수 선언이 섞여 있어도 타입 선언만 읽습니다.enum도 함께 넣어야 채워집니다. 입력에 없는 타입 이름은 null이 됩니다.type UserPage = Page<User>처럼 제네릭을 채운 별칭이 있으면 제네릭 선언보다 그 별칭을 먼저 고릅니다.HttpResponse.json(...), 테스트 픽스처, Storybook args에 넣고 값만 바꿔 씁니다.type Channel = "email" | "sms" | "push";
enum Priority { Low = "low", High = "high" }
interface Notification {
id: string;
channel: Channel;
priority: Priority;
recipient: { userId: number; locale?: string };
payload: Record<string, string>;
readAt: Date | null;
meta: Pick<Audit, "createdBy">;
}
interface Audit { createdBy: string; createdAt: Date }{
"id": "",
"channel": "email",
"priority": "low",
"recipient": {
"userId": 0,
"locale": ""
},
"payload": {
"key": ""
},
"readAt": "1970-01-01T00:00:00.000Z",
"meta": {
"createdBy": ""
}
}Channel은 문자열 리터럴 유니온이라 첫 값 "email", 문자열 enum Priority는 첫 멤버 값 "low"가 들어갔습니다. Record<string, string>은 "key" 하나짜리 객체, Date | null은 null이 아닌 쪽인 ISO 문자열이 되고, Pick<Audit, "createdBy">는 고른 키만 남습니다. 선택 속성 locale?도 결과에 포함됩니다.
string → "", number·bigint → 0, boolean → false, any·unknown → null, Date → 1970-01-01T00:00:00.000Z(Date.toJSON() 형식).null·undefined가 아닌 첫 멤버, 교차 타입(A & B)과 interface ... extends는 속성을 합칩니다.enum은 첫 멤버의 값을 쓰고, 값을 지정하지 않은 숫자 enum이면 0.Array<T>·Set<T>는 예시 원소 하나, 튜플은 각 위치의 값, Record<K, V>·Map·인덱스 시그니처는 {"key": V}.Partial·Required·Readonly·NonNullable·Pick·Omit을 지원합니다.static 필드, get/set 접근자, @Exclude() 필드를 제외합니다.children: TreeNode[])은 빈 배열로 끊습니다.백엔드가 아직 준비되지 않았을 때 API 응답 타입으로 목 데이터를 만들어 두면, 화면 개발을 먼저 진행하고 나중에 실제 API로 바꿔도 타입이 맞습니다.
컴포넌트의 props 타입에서 기본 객체를 만들어 스토리의 args나 React Testing Library 테스트의 렌더링 데이터로 씁니다. 필수 속성이 모두 들어 있어 타입 오류가 나지 않습니다.
프런트엔드에서 정의한 요청 타입을 JSON으로 바꿔 API 설계 문서나 이슈에 붙이면, TypeScript를 쓰지 않는 백엔드 개발자도 구조를 바로 이해할 수 있습니다.
?)도 모두 포함되므로, 실제로 빠질 수 있는 키는 직접 지워서 테스트해 보세요.type UserPage = Page<User>라면 items: T[]가 User로 채워지고, 인자가 없으면 <T = string> 같은 기본값을 씁니다. 제네릭 안의 조건부 타입은 여전히 계산하지 않습니다.T["key"] 같은 인덱스 접근 타입, 조건부 타입, 템플릿 리터럴 타입은 계산하지 않습니다.name = "kim", retries = 3)면 그 값을 예시에 넣고, new Date() 같은 그 밖의 초기값은 타입을 짐작하는 데만 씁니다.z.infer로 만든 타입은 직접 풀어 쓴 interface로 넣어 주세요.Map과 Set은 예시에서 객체·배열로 보여 주지만, 실제 JSON.stringify는 둘 다 {}로 바꾸므로 응답 타입에는 Record나 배열을 쓰는 것이 안전합니다.Date 타입이 문자열로 나오는 게 맞나요?네. JSON.stringify는 Date를 toJSON() 결과인 ISO 8601 문자열로 바꿉니다. 응답을 받은 쪽에서는 여전히 문자열이므로 타입을 string으로 두거나 파싱하는 코드가 필요합니다.
status: "active" | "inactive" 같은 유니온은 어떤 값이 들어가나요?선언 순서상 첫 번째 리터럴인 "active"가 들어갑니다. 다른 값을 예시로 쓰고 싶다면 유니온 순서를 바꿔서 넣으면 됩니다.
클래스 선언과 데코레이터를 읽기 때문에 class-validator 데코레이터가 붙은 DTO도 변환됩니다. class-transformer의 @Exclude() 필드는 제외합니다.
반대 방향은 JSON → TypeScript 페이지를 사용하세요. TypeORM·Sequelize·Mongoose 모델에서 JSON을 만드는 페이지도 따로 있습니다.