TypeScriptの関数エラーを回避するための設計ポイント

1. 関数エラーとは？

1. 関数エラーとは？

TypeScriptの関数エラーとは、関数を呼び出したときに起こる間違いや不具合のことです。例えば「引数の数が合わない」「数字を渡すべきところに文字を渡してしまう」などです。パソコンにとっては小さなミスでも、人間の会話で言えば「リンゴをください」と言ったのに「オレンジ」が渡されるようなものです。TypeScriptはこうしたミスを未然に防ぐために型（データの種類）をしっかり確認してくれます。

2. 引数の型を明確にする

2. 引数の型を明確にする

関数を設計するときは、まず引数（ひきすう）の型を決めることが大切です。引数とは、関数に渡す情報のことです。例えば「計算機」に数字を入力するように、関数にも必要なデータを渡します。これを明確にすることで「数字しか受け取らない関数」「文字だけ受け取る関数」といった区別ができ、エラーを防げます。

function add(a: number, b: number): number {
    return a + b;
}

    add(3, 5);   // 正しい呼び出し
    add("3", 5); // エラー（文字は受け取れない）

3. 戻り値の型を決める

3. 戻り値の型を決める

戻り値（もどりち）とは、関数が最後に返してくれる答えのことです。例えば「足し算をする関数」は計算した数を返します。この戻り値の型を明確にすると、関数を使う側が「何が返ってくるか」を安心して予想できるようになります。

function greet(name: string): string {
    return "こんにちは、" + name + "さん！";
}

    greet("太郎"); // 「こんにちは、太郎さん！」と返る

4. オプショナル引数とデフォルト引数

4. オプショナル引数とデフォルト引数

関数によっては「引数がなくても動く」場合があります。そうしたときにはオプショナル引数（?）やデフォルト引数（初期値）を使うと便利です。これによって「引数を忘れた」ときのエラーを防ぐことができます。

function sayHello(name: string = "ゲスト"): void {
    console.log("こんにちは、" + name + "さん！");
}

    sayHello();       // こんにちは、ゲストさん！
    sayHello("花子"); // こんにちは、花子さん！

5. 例外処理でエラーをつかまえる

5. 例外処理でエラーをつかまえる

関数の中で予想外の状況が起きることもあります。そのときにプログラムが止まってしまわないように、tryとcatchを使って例外処理（れいがいしょり）を行います。これは「安全ネット」を張っておくようなものです。

function divide(a: number, b: number): number {
    if (b === 0) {
        throw new Error("0で割ることはできません");
    }
    return a / b;
}

try {
    console.log(divide(10, 0));
} catch (error) {
    console.error(error);
}

6. 型推論を活用する

6. 型推論を活用する

TypeScriptには型推論（かたすいろん）という仕組みがあります。これは「代入された値を見て自動的に型を判断してくれる機能」です。ただし、型を省略しすぎると後で間違いが出やすくなります。基本は自分で型を指定しつつ、シンプルな場面で型推論を利用すると、コードが読みやすくなります。

let count = 10; // 自動的にnumber型と判断される
count = "abc";  // エラー

7. 関数設計のポイント

7. 関数設計のポイント

• 引数と戻り値の型をしっかり決める
• オプショナル引数やデフォルト引数を活用する
• 例外処理で予期せぬエラーを防ぐ
• 型推論を適切に利用する

これらの工夫をすることで、関数のエラーを大幅に減らすことができます。プログラミング初心者でも「設計の考え方」を意識するだけで、安心してTypeScriptを書けるようになります。

まとめ

まとめ

TypeScriptの関数設計では、日常のさまざまな操作と同じように、最初に正確な情報を受け取り、最後に正しい答えを返すことが重要になります。この記事で扱ってきた「引数の型」「戻り値の型」「オプショナル引数」「デフォルト引数」「例外処理」「型推論」といった基礎は、関数エラーを避けながら安全なコードを書くための土台として非常に役立ちます。特に、初めてTypeScriptを学ぶ段階では、間違ったデータが渡されたときにエラーが出る理由がわからず戸惑うことが多いですが、型を明確にすればするほど、関数がどのように動くのか自然と理解できるようになります。

関数エラーは「初心者だから起こるもの」ではなく、型が曖昧なまま設計されている結果として起こるものです。たとえば、数値を渡す場面で文字列が渡されてしまうと、関数が正常に動けなくなります。しかし、TypeScriptは「これは数字だよ」「これは文字だよ」とプログラムに伝えられるため、実際に動く前の段階でミスに気づけます。この仕組みを上手に活用すれば、複雑な処理を行う関数でも安心して書き進めることができます。

また、例外処理を組み込むことは、現実のトラブル対策に近い考え方です。たとえば割り算で0を使うような「絶対に避けたい失敗」を事前にチェックすることで、エラーが発生してもプログラムが止まらずに状況を把握できるようになります。初心者のうちは難しく感じるかもしれませんが、「安全ネットのようなもの」と考えれば理解しやすくなります。

ここで、この記事の内容をふまえて、関数のエラーを避けるための設計をまとめたサンプルコードをひとつ用意しました。引数の型、戻り値、オプショナル引数、例外処理をすべて取り入れた例です。

サンプルコード：型・オプション・例外処理を組み合わせた関数例

function calculateTotal(
    price: number,
    quantity: number = 1,
    discount?: number
): number {
    if (price < 0 || quantity < 0) {
        throw new Error("価格や数量には正の値を指定してください");
    }

    let total = price * quantity;

    if (discount !== undefined) {
        if (discount < 0 || discount > 1) {
            throw new Error("割引率は0から1のあいだで指定してください");
        }
        total = total * (1 - discount);
    }

    return total;
}

try {
    console.log(calculateTotal(1200, 2, 0.1));
} catch (error) {
    console.error(error);
}

このコードでは、価格と数量を必須の引数として指定し、割引率はオプションとして扱っています。割引が指定されなかった場合も正しく動くようになっており、さらに値が不適切なときには例外で知らせる仕組みになっています。現実のアプリ開発では、こうした細かなチェックが大きなバグを防ぐ鍵となるため、実務でもよく登場するパターンです。

関数の設計力は、プログラミング全体の理解にも直結します。関数が何を受け取り、どんな答えを返すのか、そして予期せぬ状況が起きたときにどう振る舞うかをしっかり考えておくことで、より安定したアプリケーションを作れるようになります。TypeScriptは型の仕組みがとても強力なので、この特徴を活かすことで「エラーの少ないコード」「読みやすいコード」「直しやすいコード」を自然に書けるようになるはずです。

初心者のうちは、とにかく「型を明確にする」と意識するだけで大きな一歩になります。慣れてくると、オプショナル引数やデフォルト値の扱い、例外処理の設計などにも気づきが増えていき、TypeScriptの便利さがもっと実感できるようになるでしょう。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

TypeScriptで関数エラーが起こる主な原因は何ですか？

TypeScriptの関数エラーは、引数の数が合わない、型が一致しない、戻り値の型が期待と違うなどが原因で発生します。関数設計で型を明確にすることが、エラー回避の鍵です。