TypeScriptで開発を行っていると、時折「The left-hand side of an arithmetic operation must be of type 'any', 'number', 'bigint' or an enum type.」というエラーに遭遇することがあります。このエラーは算術演算子の左側の値が適切な型でない場合に発生します。本記事では、このエラーの原因と解決方法について詳しく解説します。

エラーの原因

このエラーは主に以下の理由で発生します：

1. 文字列型の変数に対して算術演算を行おうとした場合

2. オブジェクトや配列に対して直接算術演算を行おうとした場合

3. `undefined`や`null`の値に対して算術演算を行おうとした場合

解決方法

1. 型の確認と変換

まず、演算を行う変数の型を確認し、必要に応じて適切な型に変換します。

// エラーが発生するコード
let value = "10";
let result = value + 5; // エラー

// 修正後のコード
let value = "10";
let result = Number(value) + 5; // OK

2. 型アサーション（Type Assertion）の使用

TypeScriptの型アサーションを使用して、コンパイラに変数の型を明示的に伝えることができます。

// エラーが発生するコード
let value: any = "10";
let result = value + 5; // エラー

// 修正後のコード
let value: any = "10";
let result = (value as number) + 5; // OK

3. 条件分岐による型チェック

値が期待する型であるかを条件分岐でチェックし、適切に処理します。

function addFive(value: any): number {
    if (typeof value === 'number') {
        return value + 5;
    } else if (typeof value === 'string') {
        return Number(value) + 5;
    }
    throw new Error('Invalid input type');
}

4. Optional Chaining演算子の使用

オブジェクトのプロパティにアクセスする際に、`undefined`や`null`の可能性がある場合は、Optional Chaining演算子（`?.`）を使用します。

let obj: { value?: number } = {};
let result = (obj.value ?? 0) + 5; // OK

まとめ

「The left-hand side of an arithmetic operation must be of type 'any', 'number', 'bigint' or an enum type.」エラーは、TypeScriptの型システムによる安全性チェックの結果です。このエラーを解決するには、変数の型を適切に管理し、必要に応じて型変換や型チェックを行うことが重要です。

上記の解決方法を適切に適用することで、コードの品質と型安全性を向上させることができます。TypeScriptの強力な型システムを活用し、より堅牢なアプリケーションの開発を目指しましょう。