[오류 우선순위](https://zod.dev/error-customization?id=error-precedence)
- 영어 기술 문서를 자연스럽고 정확한 한국어로 번역했습니다.
- 요청하신 대로 마크다운 구조, 헤딩, 리스트, 테이블, 코드 블록 등 포맷을 그대로 유지했으며, URL 및 코드/플래그/파일 경로 등은 변경하지 않았습니다.
모든 로케일은 "zod"에서 z.locales로 내보내지므로 편리하게 사용할 수 있습니다. 일부 번들러에서는 tree-shake되지 않을 수 있습니다.
ZodZod Mini
import * as z from "zod";
z.config(z.locales.en());사용 가능한 로케일은 다음과 같습니다:
ar— 아랍어az— 아제르바이잔어be— 벨라루스어bg— 불가리아어ca— 카탈루냐어cs— 체코어da— 덴마크어de— 독일어en— 영어eo— 에스페란토어es— 스페인어fa— 페르시아어fi— 핀란드어fr— 프랑스어frCA— 캐나다 프랑스어he— 히브리어hu— 헝가리어hy— 아르메니아어id— 인도네시아어is— 아이슬란드어it— 이탈리아어ja— 일본어ka— 조지아어km— 크메르어ko— 한국어lt— 리투아니아어mk— 마케도니아어ms— 말레이어nl— 네덜란드어no— 노르웨이어ota— 터크어ps— 파슈토어pl— 폴란드어pt— 포르투갈어ru— 러시아어sl— 슬로베니아어sv— 스웨덴어ta— 타밀어th— 태국어tr— 터키어uk— 우크라이나어ur— 우르두어uz— 우즈베크어vi— 베트남어zhCN— 간체 중국어zhTW— 번체 중국어yo— 요루바어
다음은 오류 우선순위를 빠르게 참고할 수 있는 요약입니다. 여러 커스텀 오류가 정의되어 있을 때 어떤 것이 우선권을 갖는지, 높은 순위 → 낮은 순위 순서입니다:
- 스키마 수준 오류 — 스키마 정의에 “하드코딩”된 오류 메시지입니다.
z.string("문자열이 아닙니다!");- 개별 파싱 오류 —
.parse()메서드에 넘기는 커스텀 오류 맵입니다.
z.string().parse(12, { error: (iss) => "나만의 커스텀 오류" });- 전역 오류 맵 —
z.config()에 전달되는 커스텀 오류 맵입니다.
z.config({ customError: (iss) => "나만의 커스텀 오류" });- 로케일 오류 맵 —
z.config()에 전달되는 로케일별 커스텀 오류 맵입니다.
z.config(z.locales.en());