TypeScriptでtry/catchを使わない！Result型で安全なエラー処理を実現する方法

1. プログラミングにおける例外処理とtry/catchの基本

1. プログラミングにおける例外処理とtry/catchの基本

プログラミングをしていると、どうしても予測できない問題が発生します。例えば、インターネットからデータをもらうときに通信が切れたり、存在しないファイルを開こうとしたりすることです。これらを専門用語で例外と呼びます。従来のプログラムでは、この例外が起きると処理が強制終了してしまうため、try/catchという仕組みを使って処理をキャッチし、止まらないようにしてきました。

try/catchは、成功するか失敗するかわからないコードを「try（試す）」ブロックに入れ、もし問題があれば「catch（捕まえる）」ブロックで対応するという流れです。しかし、これがコードのあちこちに散らばると、どこで何が起きるのか把握しづらくなってしまうという欠点があります。

2. なぜtry/catchを使わない設計が推奨されるのか

2. なぜtry/catchを使わない設計が推奨されるのか

なぜtry/catchを避けるべきだと言われるのでしょうか。最大の理由は「処理の流れが見えなくなること」にあります。関数が失敗したとき、どのエラーがどこで投げられるのか、TypeScriptの型システムだけでは追いかけるのが難しいためです。開発者が「この関数はエラーを投げるかもしれない」と覚えておかなければならず、見落としが発生しやすいのです。

そこで登場するのがResult型という考え方です。Result型は、「成功したときは値を持つ」と「失敗したときはエラーの理由を持つ」という二つの状態を型として明確に定義します。これにより、エラーもデータの一部として扱うことができ、プログラマーは強制的にエラーの発生を考慮するように設計できるようになります。

3. TypeScriptでResult型を自作する方法

3. TypeScriptでResult型を自作する方法

TypeScriptには標準でResult型が用意されているわけではありませんが、自分で簡単に作ることができます。型定義と呼ばれる機能を使って、成功と失敗の状態を定義します。まずはシンプルな実装例を見てみましょう。

type Success<T> = { success: true; data: T };
type Failure = { success: false; error: string };
type Result<T> = Success<T> | Failure;

function divide(a: number, b: number): Result<number> {
    if (b === 0) {
        return { success: false, error: "ゼロで割ることはできません" };
    }
    return { success: true, data: a / b };
}

このコードでは、Success型とFailure型を定義し、それらを合体させたResult型を作成しました。ジェネリクスという機能（型をあとから決める仕組み）を使い、成功したときに返すデータの型を自由に設定できるようにしています。このように定義することで、関数の結果がどちらの形になるのかをTypeScriptが理解できるようになります。

4. 型による安全性を担保するとはどういうことか

4. 型による安全性を担保するとはどういうことか

TypeScriptの強力な機能である型ガードを使うことで、実行結果の安全性を担保します。型ガードとは、条件分岐を使って、変数の型を特定する仕組みです。下記のコードを見てください。

const result = divide(10, 0);

if (result.success) {
    console.log("計算結果:", result.data);
} else {
    console.error("エラーが発生しました:", result.error);
}

この例では、if文を使ってresult.successがtrueかどうかをチェックしています。もしtrueであれば、TypeScriptは「あ、これは成功したデータだからdataプロパティがあるんだな」と判断してくれます。逆にelseブロックでは「これはエラーデータだからerrorプロパティがあるはずだ」と判断し、安全に値へアクセスできるようになります。これが、実行前に型によって安全性が保証されるという仕組みです。

5. 実際の現場でのResult型活用メリット

5. 実際の現場でのResult型活用メリット

実際の開発現場では、多くの関数や通信処理が組み合わさります。Result型を使うと、エラーの処理が関数を呼ぶ側で強制されるため、バグの混入を劇的に減らすことができます。特に大規模なアプリケーションでは、何百もの関数を組み合わせて使うため、エラーを型として扱うメリットは計り知れません。

例えば、データベースにアクセスしたり、APIという外部サービスと連携したりするとき、成功と失敗の型が明示されていると、開発者はエラー処理を書き忘れることがありません。これは保守性が高いコードを作るための重要な技術です。最初は少し書き方が増えるように感じるかもしれませんが、将来的な修正のしやすさを考えると非常に合理的です。

6. 複雑な条件を扱うための実践コード

6. 複雑な条件を扱うための実践コード

最後に、少し発展的な例として、処理を連続して実行する場合の例を見てみましょう。Result型は連続する処理でも威力を発揮します。

function getUserId(name: string): Result<number> {
    if (name === "admin") return { success: true, data: 1 };
    return { success: false, error: "ユーザーが存在しません" };
}

const userResult = getUserId("guest");

if (!userResult.success) {
    console.log("処理を中止します:", userResult.error);
} else {
    const userId = userResult.data;
    console.log("ユーザーID:", userId);
}

このように、一つの関数だけでなく、プログラム全体でResult型を統一して使うことで、エラー処理のルールが整います。結果として、デバッグ（プログラムの誤りを見つけて修正する作業）が非常に楽になります。例外を投げ飛ばしてどこで捕まえるか悩む必要はなく、その場で結果を確認して次に進むという、明確で健全なプログラムが書けるようになるのです。