JavaScriptで「数値のつもりで渡した値が文字列だった」といった間違いを、実行前に見つけやすくするのがTypeScriptです。JavaScriptを置き換えて卒業するというより、JavaScriptに型チェックを加えて使います。この記事では小さな関数で型エラーを確かめ、検出できる問題とできない問題を分けて理解します。
JavaScriptにも型はある
JavaScriptの値には、数値、文字列、真偽値などの型があります。変数に異なる種類の値を代入できる動的型付けの言語です。TypeScriptは型注釈や型推論を使い、値の使い方が整合しているかを実行前に検査します。
例えば数値として扱う変数に文字列を代入すると、TypeScriptの型チェックが指摘します。指摘されるタイミングはエディターやビルド設定によるため、「保存すれば必ず分かる」とは限りません。
let count: number = 5;
count = "hello"; // 意図的な型エラー
公式Playgroundで型エラーを確かめる
TypeScript Playgroundを開き、TypeScriptの編集欄に次のコードを入力します。まず実行する前に、最後の行に型の指摘が出ることを確認してください。
function greet(name: string): string {
return "こんにちは、" + name + "さん!";
}
console.log(greet("Taro"));
console.log(greet(123)); // 数値を渡したため型エラー
引数nameの後のstringは「文字列を受け取る」、関数の丸括弧の後のstringは「文字列を返す」という指定です。最後の行をconsole.log(greet("Hanako"));に直すと、この型の不一致は解消します。Runで実行すると、ログにはTaroさんとHanakoさんへの挨拶が出ます。
変換後のJavaScriptも見比べてみましょう。型注釈はJavaScriptに残りません。型チェックとプログラムの実行は別の段階です。設定によっては型エラーがあってもJavaScriptが生成されるため、生成できたことだけで型チェック合格とは判断できません。
最初に使う型と型推論
number:数値。例は5や1.5。string:文字列。例は”Taro”。boolean:trueまたはfalse。number[]:数値の配列。{ name: string; age: number }:nameとageを持つオブジェクトの型。
let total = 0; // numberと推論される
const scores: number[] = [60, 80];
const user: { name: string; age: number } = {
name: "Taro",
age: 30
};
型注釈を省いても、代入値などから型が推論される場面があります。すべての変数に注釈を付ける必要はありません。最初は関数の引数に型を付け、値を渡す側との約束を明確にする練習から始めると使いどころが分かります。
TypeScriptでも防げないこと
- 計算や仕様の間違い:足し算すべき場所を引き算しても、数値同士なら型だけでは意図を判断できません。
- 実行時の外部データ:APIや入力から届くデータが想定通りかは、必要に応じて実行時に検証します。型注釈だけでデータの中身は検査されません。
- 通信失敗や権限の問題:型が合っていても、ネットワークやサーバーの状態で処理が失敗することがあります。
型エラーを消すためだけにanyを付けると、その部分のチェックが弱くなります。まず「何を受け取り、何を返すべきか」を確かめましょう。型アサーションを付けても実際の値が変わるわけではありません。テストや入力検証は、型チェックと組み合わせて使います。
次に試すこと
自分が書いたJavaScriptの小さな関数を1つ選び、引数と戻り値に型を付けてください。正しい値、間違った型の値、空文字などの境界となる値を渡して、型チェックで見つかるものと、実行して確認するものを分けると学習が進みます。JavaScriptの関数がまだ難しい場合は、先にJavaScript入門へ戻って構いません。
型チェック、変換、型注釈の除去についてはTypeScript公式Handbook「The Basics」に説明があります。
次に読む記事
質問しながら学習を進めたい方へ
型エラーの文面と、関数に渡したい値をセットで整理すると、修正の理由まで確認しやすくなります。 CodeNestでは、AIへの質問や演習を通じたプログラミング学習を案内しています。学べる内容と利用条件をCodeNestの公式案内で確認し、自分が取り組みたい課題に合うかを検討してください。
