TypeScript入門:型を付けて安全に書く小さな集計ツールの作り方

TypeScript入門:型を付けて安全に書く小さな集計ツールの作り方 TypeScript

こんにちは!ともです。JavaScriptで小さな道具を作れるようになると、次にぶつかるのが「データの形が想定と違って、実行してみるまで間違いに気づけない」という壁です。金額のつもりが文字列だった、項目名を打ち間違えた、といったミスは、規模が小さいうちほど見落としがちです。

この記事では、JavaScriptに「型」の考え方を足した言語、TypeScriptの入門として、名前と金額のデータを読み取って合計と平均を出す小さな集計ツールを作ります。データの形を型で先に決めておくことで、形の食い違いを実行前に指摘してもらえる書き方を体験する作例です。

この記事で分かること

この記事で分かること
この記事で分かること
  • 型つきで書く集計ツールの完成形
  • 必要なものとコスト(無料でそろう範囲)
  • Node.jsの確認から、TypeScriptの導入、設定ファイルの用意までの手順
  • データの形を型(interface)で決める書き方
  • 集計して結果を表示する処理の骨格
  • つまずきやすい点と直し方

完成品のイメージ:形を決めたデータから、合計と平均が出る

完成品のイメージ:形を決めたデータから、合計と平均が出る
完成品のイメージ:形を決めたデータから、合計と平均が出る

完成すると、ターミナル(コマンドを打つ黒い画面)でコマンドを1つ実行するだけで、「合計金額」と「平均金額」が表示されるツールが手に入ります。題材のデータは、名前と金額の組をカンマで区切った、CSV風のテキストです。

見どころは、データの形を「名前は文字列、金額は数値」と型で宣言している点です。もし金額の場所に文字列を入れるようなコードを書くと、実行する前の段階で、エディタや変換の時点で「ここが型と合いません」と指摘されます。

小さなツールですが、「型で形を決める→形に沿って処理を書く→変換して実行する」という、TypeScriptの基本の流れが一通り入っています。

必要なものとコスト

必要なものとコスト
必要なものとコスト

使うものは、Node.jsとTypeScriptだけです。TypeScriptは無料で公開されており、料金はかかりません(2026年11月確認時点)。

項目内容
使うツールNode.js/TypeScript(5.x系)/テキストエディタ(VS Codeなど)
料金の目安無料(約0円)
前提ターミナルの基本操作/JavaScriptの基本(変数・関数・配列)に触れたことがあると読みやすい

TypeScriptは、ブラウザやNode.jsがそのまま実行できる言語ではありません。書いたコードを「コンパイル(変換)」してJavaScriptに直してから実行する、という一手間が入ります。この記事では、その変換も含めて手順を追います。

Node.jsがまだ入っていない場合は、先にインストールの記事で用意を済ませておいてください。

Node.jsのインストール手順

難易度と進め方の目安

難易度と進め方の目安
難易度と進め方の目安

難易度は中くらいです。コードの量自体は多くありませんが、「プロジェクトの用意」「設定ファイル」「コンパイル」という、JavaScriptだけのときには無かった段取りが出てきます。目安の所要時間は、初期設定込みで1時間前後です。

進め方は「Node.jsの確認→プロジェクトの用意→TypeScriptの導入→設定ファイルの用意→型と集計のコードを書く→コンパイルして実行」の順番です。JavaScriptの基礎に不安がある場合は、先にブラウザで動く入門の作例に触れておくと、用語がつながります。

JavaScript入門:ブラウザだけで動く文字数カウンターを作る手順

インストール・初期設定:Node.jsの確認からTypeScriptの導入まで

インストール・初期設定:Node.jsの確認からTypeScriptの導入まで
インストール・初期設定:Node.jsの確認からTypeScriptの導入まで

まず、Node.jsが使えるかを確認します。ターミナルで次のコマンドを打ち、バージョンの数字が表示されれば用意ができています。

# Node.jsのバージョンを表示する(数字が出ればインストール済み)
node -v

# npm(Node.jsの部品管理ツール)のバージョンを表示する
npm -v

次に、作業用のフォルダを作って移動し、プロジェクトの土台を用意します。

# 作業用フォルダを作って、その中へ移動する
mkdir ts-summary
cd ts-summary

# プロジェクトの土台(package.json)を作る。質問はすべて Enter で進めてよい
npm init -y

# TypeScriptをこのプロジェクト専用にインストールする
npm install --save-dev typescript

インストールが終わったら、TypeScript用の設定ファイルを用意します。自動生成コマンドで土台を作り、この記事で使う最小限の形に整えます。

# 設定ファイル(tsconfig.json)の土台を自動生成する
npx tsc --init

生成された tsconfig.json の中身を、次の形に書き換えます。設定項目は数多くありますが、入門の段階では「どこにあるコードを変換して、どこへ出すか」が分かれば十分です。

{
  "compilerOptions": {
    // 変換先のJavaScriptの世代(最近のNode.jsで動く指定)
    "target": "ES2020",
    // 部品の読み込み方式(Node.jsで一般的な指定)
    "module": "commonjs",
    // 変換したファイルを出すフォルダ
    "outDir": "dist",
    // 型の食い違いを厳しくチェックする(TypeScriptの利点の中心)
    "strict": true
  },
  // 変換の対象にするフォルダ
  "include": ["src"]
}

最後に、コードを置くフォルダsrcを作れば初期設定は完了です。このあとのコードは、すべてこのsrcの中に書いていきます。

作り方の骨格1:データの形を型で決める

作り方の骨格1:データの形を型で決める
作り方の骨格1:データの形を型で決める

TypeScriptの中心は「型」です。まず、扱うデータ1件分の形をinterfaceで宣言します。ここで決めた形が、この先のすべての処理の約束事になります。

// データ1件分の形を決める型(名前は文字列、金額は数値)
interface RecordItem {
  name: string;   // 名前:文字列
  amount: number; // 金額:数値
}

// 題材のデータ(CSV風のテキストを、行ごとに用意したもの)
const csvText = `りんご,120
みかん,80
ぶどう,300`;

// CSV風テキストを、型つきのデータの配列に変換する処理
function parseRecords(text: string): RecordItem[] {
  // 改行で分割して、1行ずつの配列にする
  return text.split('\n').map(function (line) {
    // カンマで分割して、名前と金額の文字列を取り出す
    const parts = line.split(',');
    // 型に合わせて、金額は数値に変換してから返す
    return {
      name: parts[0],
      amount: Number(parts[1])
    };
  });
}

ポイントは、金額をNumber(...)で数値に変換してから型に合わせているところです。テキストから取り出した値はすべて文字列なので、数値として扱いたい場所では、この変換が欠かせません。

もし変換を忘れて文字列のまま入れようとすると、コンパイルの時点で「string は number に合いません」という指摘が出ます。実行してから壊れるのではなく、書いた段階で気づける。これが型を付ける一番の利点です。

作り方の骨格2:集計して結果を表示する

作り方の骨格2:集計して結果を表示する
作り方の骨格2:集計して結果を表示する

次に、型つきのデータを受け取って、合計と平均を計算する処理を書きます。骨格1のコードの下に続けてください。ファイル名はsrc/main.tsとします。

// 型つきデータの配列を受け取り、合計と平均を出す処理
function summarize(records: RecordItem[]): { total: number; average: number } {
  // 金額だけを取り出して、すべて足し合わせる
  const total = records.reduce(function (sum, record) {
    return sum + record.amount;
  }, 0);

  // 平均は「合計 ÷ 件数」。件数が0のときは、0で割らないよう0を返す
  const average = records.length === 0 ? 0 : total / records.length;

  // 結果をまとめて返す
  return { total: total, average: average };
}

// ここから実行部分:データを変換して、集計して、結果を表示する
const records = parseRecords(csvText);
const result = summarize(records);

// 結果をターミナルに表示する
console.log('件数:' + records.length + '件');
console.log('合計金額:' + result.total + '円');
console.log('平均金額:' + result.average + '円');

集計の処理が受け取る引数にも型(RecordItem[])が付いているため、「金額は数値であること」が前提として保証されます。文字列のまま足し算してしまうような事故が、型の段階で防がれる形です。

コードが書けたら、コンパイルして実行します。

# TypeScriptをJavaScriptへ変換する(dist フォルダにファイルが出る)
npx tsc

# 変換されたJavaScriptを実行する
node dist/main.js

「合計金額:500円」「平均金額:166.666…円」のように表示されれば完成です。平均が割り切れない場合は小数で表示されます。気になる場合は、表示の直前で四捨五入する処理を足してみてください。

つまずきやすい点

つまずきやすい点
つまずきやすい点

よくあるつまずきは5つです。1つ目は、コンパイルを忘れて「直したのに結果が変わらない」状態になることです。実行しているのは変換後のJavaScriptなので、コードを直したらnpx tscを再実行するのが手順に含まれます。

2つ目は、型の指摘を「エラーがうるさい」と感じて、安易にany(何でもよい型)で逃がしてしまうことです。anyを付けた場所は、型の利点が消えてしまいます。指摘は「形が食い違っている場所の知らせ」として、まずデータの形を見直してください。

3つ目は、設定ファイル(tsconfig.json)の置き場所です。プロジェクトの土台(package.json)と同じフォルダに置くのが基本です。場所がずれると、変換の対象が見つからず、何も出力されないことがあります。

4つ目は、srcフォルダとincludeの指定の食い違いです。コードを置くフォルダ名を変えた場合は、設定側のincludeも合わせて直してください。変換対象から外れると、実行ファイルが古いままになります。

5つ目は、カンマ区切りのデータに余分な空白や空行が混ざることです。末尾に空行があると、空のデータとして読み取られて金額がNaN(数値ではない)になることがあります。題材データの末尾は、改行で終わらせない形にそろえてください。

まとめ

まとめ
まとめ

TypeScriptの入門は、「プロジェクトを用意する→設定ファイルを整える→型でデータの形を決める→形に沿って処理を書く→コンパイルして実行する」という流れで進みます。型は「実行前に間違いを指摘してもらうための約束事」だと捉えると、役割がつかみやすくなります。

慣れてきたら、題材データを実際のCSVファイルから読み込む形に広げたり、項目を足して型を育てたりしてみてください。型がしっかりしているほど、あとからの変更で壊れる場所が減っていきます。

TypeScriptは、Webページを作るフレームワークでも広く使われています。ページとフォームを作る作例に進むと、型つきの書き方が画面側でも生きてきます。

Next.js入門:小さなWebページとフォームを作る手順

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました