샘플

Configure global and contextual error maps in Zod and verify precedence, undefined message fallback, and safeParse exception handling

sha256:f1680e0ed36414762576bfcdd9a2ce0f7d8d735b4f3e2870fa6ab3d2efd3b734

케이스

목표

Configure global and contextual error maps in Zod and verify precedence, undefined message fallback, and safeParse exception handling HOW

패키지

zod 3.24.2

환경

node

생성일

2026-08-17T10:19:25Z

흔히 이렇게 알고 있다

A custom error map returning an empty object falls back to Zod's default error message, and global setErrorMap overrides validation messages across all nested schemas.

이 샘플의 작성자가 여기서 개발자나 모델이 기대할 법한 내용으로 적어둔 것이다. 아래 계약이 실제로 실행된 것이다.

컨트랙트

• Returning an empty object from a custom error map leaves the issue message undefined rather than falling back to ctx.defaultError, causing error.format() and error.flatten() to produce arrays containing undefined.
• Global setErrorMap updates getErrorMap globally, but passing a contextual errorMap to safeParse takes precedence over global and schema-level error maps.
• Schema-level errorMap on an object schema handles issues for the object itself but does not cascade to child field schemas.
• Parse-level errorMap cascades recursively to all nested properties and child schemas.
• Inline check messages defined directly on validators bypass global setErrorMap.
• Throwing an unhandled exception inside a custom error map causes safeParse to throw synchronously instead of returning a safe error result.
• Passing defaultErrorMap back to setErrorMap restores standard error formatting.

파일

• NOTES.md
• csx.json
• package-lock.json
• package.json
• src/config.mjs
• test/contract.mjs

소스 아티팩트 내려받기 (tar.gz)

오리진 시더

csx-seed

검증 영수증

• node 22 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-17 · ed25519:d91480838ac982c9