0Pricing
TypeScript Academy · レッスン

Resultパターン:OkとErr

例外をthrowする代わりに、エラーを値として返します。

「Resultパターン:OkとErr」はCoddyKit上の無料TypeScript Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはTypeScript Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 TypeScript Academyコースには全4レッスンが含まれています。

ようこそ

Resultパターンはエラーを値として返すため、try/catchを使わずに型安全なエラーハンドリングを実現できます。

Result型

OkとErrのバリアントを持つジェネリックResult型を定義します。
type Ok<T> = { ok: true; value: T };
type Err<E = Error> = { ok: false; error: E };
type Result<T, E = Error> = Ok<T> | Err<E>;

ヘルパーコンストラクター

コードを読みやすくするために、ok()とerr()のヘルパーを作成します。
const ok = <T>(value: T): Ok<T> => ({ ok: true, value });
const err = <E>(error: E): Err<E> => ({ ok: false, error });

Resultの返却

例外をスローする代わりに、関数からResultを返します。
async function fetchUser(id: number): Promise<Result<User>> {
  try {
    const user = await db.findUser(id);
    if (!user) return err(new Error('Not found'));
    return ok(user);
  } catch (e) { return err(e as Error); }
}

Resultの利用

値を使用する前にokフラグを確認します。
const result = await fetchUser(1);
if (result.ok) {
  console.log(result.value.name); // User
} else {
  console.error(result.error.message);
}

mapResultヘルパー

成功したResultに対してマッピングを行い、値を変換します。
function mapResult<T, U, E>(r: Result<T, E>, fn: (v: T) => U): Result<U, E> {
  return r.ok ? ok(fn(r.value)) : r;
}

flatMapResultヘルパー

Resultを返す関数を安全にチェーンします。
function flatMap<T, U, E>(r: Result<T, E>, fn: (v: T) => Result<U, E>): Result<U, E> {
  return r.ok ? fn(r.value) : r;
}

Resultと例外の比較

例外は暗黙的で、型付けされていません。Resultは型シグネチャに明示される値です。

ライブラリのサポート

neverthrow、true-myth、fp-tsなどのライブラリは、本番環境で利用できるResult型を提供します。

APIハンドラーでのResult

ExpressのハンドラーでResultを使用すると、エラーをすっきりと伝播できます。
app.get('/users/:id', async (req, res) => {
  const result = await fetchUser(parseInt(req.params.id));
  if (result.ok) res.json(result.value);
  else res.status(404).json({ error: result.error.message });
});

非同期Result

Promise>を使用して、非同期処理とResultパターンを組み合わせます。
type AsyncResult<T, E = Error> = Promise<Result<T, E>>;

確認問題

例外をスローする場合と比べて、Resultパターンにはどのような主な利点がありますか?

まとめ

Resultパターン、OkとErr:このトピックの重要な概念と、実際のTypeScriptプロジェクトでの適用方法を学びました。

よくある質問

「Resultパターン:OkとErr」レッスンは無料ですか?

はい。「Resultパターン:OkとErr」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、TypeScript Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 TypeScript Academyコースには全4レッスンが含まれています。

「Resultパターン:OkとErr」で何を学びますか?

例外をthrowする代わりに、エラーを値として返します。 ブラウザで直接実行するハンズオンコードでTypeScript Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

TypeScript Academyを始めるのに経験は必要ですか?

事前経験は必要ありません。CoddyKitのTypeScript Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。

「Resultパターン:OkとErr」レッスンにはどのくらい時間がかかりますか?

ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このTypeScript Academyレッスンでコードを書いて実行できますか?

はい。すべてのTypeScript Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. 型付きErrorクラスと階層
  2. Resultパターン:OkとErr
  3. 捕捉したErrorのナローイング(unknownとError)
  4. 非同期TypeScriptコードのエラーハンドリング
← TypeScript Academyに戻る