parse() vs safeParse() in Zod
From the Zod cheat sheet · Parsing & Error Handling · verified Jul 2026
parse() vs safeParse()
Throwing and non-throwing parse methods
typescript
// parse - throws on error
try {
const user = UserSchema.parse(data);
} catch (err) {
if (err instanceof z.ZodError) {
console.log(err.issues);
}
}
// safeParse - returns result object
const result = UserSchema.safeParse(data);
if (result.success) {
console.log(result.data);
} else {
console.log(result.error.issues);
}💡 Prefer safeParse() in API routes — no try/catch, cleaner control flow
⚡ z.flattenError() is perfect for form validation — gives field-level error arrays
📌 Use parseAsync() when your schema has async refinements like database lookups
🟢 ZodError.issues is an array — each issue has code, path, message for granular handling
parsesafeParseerrors