ホーム 全セッション S03

schema による検査と Result の返却

8 / 18 目安 1.5分

ページ一覧

事前知識: schema で検査した結果を、Result につなぐ手段が必要です。

schemaResult は、この教材の関数です。schema を受け取り、unknown の値を検査して Ok か Err を返す関数を、戻り値として返します。

1つの schema から実行時の検査を作る仕組み schema から schemaResult で、実行時の検査である parse を作ります。parse は raw を unknown として受け取ります。night-shift という値は parse の検査で Err になり、UUID の形をした値は Ok になって内側へ進みます。 実行時(JavaScript) schema z.object({…}) schemaResult 検査 parse(検査あり) 内側 (業務の処理) "3f2b…" raw: unknown "night-shift" "3f2b…" ✕ Err ✓ Ok ✓ Ok
  1. 実行時の検査も、同じ schema から作ります。この教材では、schema から検査を作る関数 schemaResult を使います。T は検査を通った値の型で、z.ZodType の残りの引数は読み飛ばしてかまいません。

    examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27
    export 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();
      };
  2. schemaResult は、関数を返す関数です。schema を1つ受け取り、raw を受け取る別の関数を返します。返された関数が parse です。

    examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27
    export 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();
      };
  3. 返された関数は、raw を unknown として受け取ります。unknown は、中身を検証するまで項目を使えない型です。

    examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27
    export 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();
      };
  4. safeParse は、schema で raw を検査します。検査に失敗しても例外を投げず、成否を success に格納して返します。schemaResult は success を参照して、Ok か Err を返します。

    examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27
    export 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();
      };
  5. schemaResult が返す関数に night-shift を渡すと Err になり、UUID の形の値を渡すと Ok になって内側へ進みます。使う場所は「境界を通過した値だけを内側へ渡す構成」のページで確認します。

    examples/session-03-solution/src/domain/shared/schemaResult.ts:23-27
    export 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();
      };