0Pricing
TypeScript Academy · 강의

zod를 사용한 실행 시간 검증(입문)

zod 스키마로 실행 시간에 JSON 응답을 검증해 컴파일 시간 타입을 넘어서는 안전성을 확보합니다.

zod를 사용한 실행 시간 검증(입문)은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 2개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 2개의 강의가 포함되어 있습니다.

소개

목표: zod로 실행 시 안전성을 추가합니다. 컴파일 시 형식만으로는 충분하지 않으므로 스키마로 실제 데이터를 검증합니다.

zod 설치

TS/JS용으로 널리 사용되는 실행 시 스키마 검증 라이브러리인 zod를 설치하십시오.

npm install zod

스키마 정의

z.object()로 스키마를 만드십시오. z.infer<typeof Schema>를 사용하면 스키마에서 TS 형식을 생성할 수 있습니다.

import { z } from "zod";

const UserSchema = z.object({
  id: z.number(),
  name: z.string()
});

type User = z.infer<typeof UserSchema>;

Schema.parse()

Schema.parse()를 호출하여 데이터를 검증하십시오. JSON이 스키마와 일치하지 않으면 오류가 발생합니다.

async function getUser() {
  const res = await fetch("/user.json");
  const raw = await res.json();
  const parsed = UserSchema.parse(raw);
  console.log(parsed.id, parsed.name);
}

safeParse

safeParse는 success와 error 필드가 있는 객체를 반환합니다. 예외를 발생시키는 것보다 안전합니다.

const result = UserSchema.safeParse(raw);
if (!result.success) {
  console.error(result.error);
} else {
  console.log(result.data);
}

중첩 스키마

스키마는 배열, 객체, 선택적 필드 등으로 중첩할 수 있습니다.

const PostSchema = z.object({
  id: z.number(),
  title: z.string(),
  tags: z.array(z.string())
});

const raw = { id: 1, title: "Hello", tags: ["ts", "zod"] };
const post = PostSchema.parse(raw);

검증 확인

빠른 확인: JSON을 구문 분석한 후 zod 검증을 사용하는 이유는 무엇입니까?

복습

복습: zod 스키마는 실행 시 JSON을 검증합니다. 안전성을 보장하려면 parse 또는 safeParse를 사용하십시오.

자주 묻는 질문

“zod를 사용한 실행 시간 검증(입문)” 강의는 무료인가요?

네 — “zod를 사용한 실행 시간 검증(입문)” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 2개의 강의가 포함되어 있습니다.

“zod를 사용한 실행 시간 검증(입문)”에서 뭘 배우나요?

zod 스키마로 실행 시간에 JSON 응답을 검증해 컴파일 시간 타입을 넘어서는 안전성을 확보합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 2개 중 2번째 강의입니다.

“zod를 사용한 실행 시간 검증(입문)” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Fetch API 타입과 Response.json() 제네릭
  2. zod를 사용한 실행 시간 검증(입문)
← TypeScript Academy(으)로 돌아가기