schemaResult は、この教材の関数です。schema を受け取り、unknown の値を検査して Ok か Err を返す関数を、戻り値として返します。
-
実行時の検査も、同じ schema から作ります。この教材では、schema から検査を作る関数 schemaResult を使います。T は検査を通った値の型で、z.ZodType の残りの引数は読み飛ばしてかまいません。
examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27export const schemaResult = <T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>) => (raw: unknown): Result<T> => { const parsed = schema.safeParse(raw); return parsed.success ? ok(parsed.data) : err(); }; -
schemaResult は、関数を返す関数です。schema を1つ受け取り、raw を受け取る別の関数を返します。返された関数が parse です。
examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27export const schemaResult = <T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>) => (raw: unknown): Result<T> => { const parsed = schema.safeParse(raw); return parsed.success ? ok(parsed.data) : err(); }; -
返された関数は、raw を unknown として受け取ります。unknown は、中身を検証するまで項目を使えない型です。
examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27export const schemaResult = <T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>) => (raw: unknown): Result<T> => { const parsed = schema.safeParse(raw); return parsed.success ? ok(parsed.data) : err(); }; -
safeParse は、schema で raw を検査します。検査に失敗しても例外を投げず、成否を success に格納して返します。schemaResult は success を参照して、Ok か Err を返します。
examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27export const schemaResult = <T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>) => (raw: unknown): Result<T> => { const parsed = schema.safeParse(raw); return parsed.success ? ok(parsed.data) : err(); }; -
schemaResult が返す関数に night-shift を渡すと Err になり、UUID の形の値を渡すと Ok になって内側へ進みます。使う場所は「境界を通過した値だけを内側へ渡す構成」のページで確認します。
examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27export const schemaResult = <T>(schema: z.ZodType<T, z.ZodTypeDef, unknown>) => (raw: unknown): Result<T> => { const parsed = schema.safeParse(raw); return parsed.success ? ok(parsed.data) : err(); };