Validate h3 and Nuxt requests with zod.
npm install zod h3-zod
Import it like:
import { zh } from 'h3-zod';
// Or
import { useSafeValidatedQuery, useSafeValidatedBody } from 'h3-zod';
Helpers that don't throw when parsing fails:
export default defineEventHandler(async (event) => {
const query = zh.useSafeValidatedQuery(event, z.object({
required: z.string()
}))
const body = await zh.useSafeValidatedBody(event, z.object({
optional: z.string().optional(),
required: z.boolean()
}))
const params = zh.useSafeValidatedParams(event, {
id: z.number()
})
})
Helpers that throw error 400 when parsing fails:
export default defineEventHandler(async (event) => {
const query = zh.useValidatedQuery(event, z.object({
required: z.string()
}))
const body = await zh.useValidatedBody(event, z.object({
optional: z.string().optional(),
required: z.boolean()
}))
const params = zh.useValidatedParams(event, {
id: z.number()
})
})
You can also pass an object schema:
export default defineEventHandler(async (event) => {
const body = await zh.useValidatedBody(event, {
optional: z.string().optional(),
required: z.boolean()
})
})
"true"
→true
"false"
→false
"notboolean"
→ throwsZodError
"on"
→true
undefined
→false
"anythingbuton"
→ throwsZodError
"3"
→3
"3.14"
→ throwsZodError
"notanumber"
→ throwsZodError
"3"
→3
"3.14"
→3.14
"notanumber"
→ throwsZodError
const Schema = z.object({
isAdmin: zh.boolAsString,
agreedToTerms: zh.checkboxAsString,
age: zh.intAsString,
cost: zh.numAsString,
});
const parsed = Schema.parse({
isAdmin: 'true',
agreedToTerms: 'on',
age: '38',
cost: '10.99'
});
console.log(parsed)
// {
// isAdmin: true,
// agreedToTerms: true,
// age: 38,
// cost: 10.99
// }
MIT