12.1 課題と準備

作るもの

売上データの JSON を読み込み、商品ごとの売上合計を降順で出力するスクリプトを作ります。

準備

$ mkdir handson && cd handson
$ npm init -y
$ npm i -D typescript tsx @types/node

sales.json を用意します。

[
	{ "date": "2026-01-15", "product": "ノート", "amount": 1200, "qty": 3 },
	{ "date": "2026-01-16", "product": "ペン", "amount": 300, "qty": 10 },
	{ "date": "2026-02-01", "product": "ノート", "amount": 800, "qty": 2 },
	{ "date": "2026-02-03", "product": "消しゴム", "amount": 150, "qty": 5 },
	{ "date": "2026-02-20", "product": "ペン", "amount": 450, "qty": 15 }
]

目指す出力

$ npx tsx step4.ts
ノート: 2000 円
ペン: 750 円
消しゴム: 150 円

12.2 4段階で型を付けていく

段階1 — まず動かす

型を気にせず、JavaScript を書く要領で動かします。

// step1.ts
import { readFileSync } from "node:fs";

const text = readFileSync("sales.json", "utf8");
const sales = JSON.parse(text);

const totals: any = {};
for (const s of sales) {
	totals[s.product] = (totals[s.product] ?? 0) + s.amount;
}

console.log(totals);

$ npx tsx step1.ts
{ 'ノート': 2000, 'ペン': 750, '消しゴム': 150 }

やってみること

• s.product を s.prodcut に変えて実行し、エラーにならないことを確かめる
• npx tsc --noEmit step1.ts を実行し、それでも通ることを確かめる

段階2 — 型を付ける

データの形を type で書き、集計結果を Map に変えます。

// step2.ts
import { readFileSync } from "node:fs";

type Sale = { date: string; product: string; amount: number; qty: number };

const text = readFileSync("sales.json", "utf8");
const sales = JSON.parse(text) as Sale[];      // ← まだ嘘をついている

function sumByProduct(sales: Sale[]): Map<string, number> {
	const out = new Map<string, number>();
	for (const s of sales) {
		out.set(s.product, (out.get(s.product) ?? 0) + s.amount);
	}
	return out;
}

for (const [product, total] of sumByProduct(sales)) {
	console.log(`${product}: ${total} 円`);
}

やってみること

• sales.json の amount を "1200"（文字列）に書き換えて実行する
• 型エラーは出ず、集計結果がおかしくなることを確かめる

段階3 — 検証を入れる

as をやめ、unknown で受けて型ガードで確かめます（08）。

// step3.ts（抜粋）
function isSale(v: unknown): v is Sale {
	if (typeof v !== "object" || v === null) return false;
	const o = v as Record<string, unknown>;
	return (
		typeof o.date === "string" &&
		typeof o.product === "string" &&
		typeof o.amount === "number" &&
		typeof o.qty === "number"
	);
}

const parsed: unknown = JSON.parse(text);

if (!Array.isArray(parsed)) {
	throw new Error("配列ではありません");
}

const sales: Sale[] = [];
for (let i = 0; i < parsed.length; i++) {
	const row: unknown = parsed[i];
	if (!isSale(row)) {
		throw new Error(`${i} 件目の形式が不正です`);
	}
	sales.push(row);
}

やってみること

• 再び amount を文字列に変えて実行し、件数付きのエラーで止まることを確かめる

段階4 — エラー処理を整える

例外を投げる代わりに Result を返し、呼ぶ側に対処を強制します（11）。

12.3 解答例と詰まりやすい箇所

解答例（段階4）

// step4.ts
import { readFileSync } from "node:fs";

type Sale = { date: string; product: string; amount: number; qty: number };

type Result<T, E = Error> =
	| { ok: true; value: T }
	| { ok: false; error: E };

function isSale(v: unknown): v is Sale {
	if (typeof v !== "object" || v === null) return false;
	const o = v as Record<string, unknown>;
	return (
		typeof o.date === "string" &&
		typeof o.product === "string" &&
		typeof o.amount === "number" &&
		typeof o.qty === "number"
	);
}

function loadSales(path: string): Result<Sale[]> {
	let text: string;
	try {
		text = readFileSync(path, "utf8");
	} catch {
		return { ok: false, error: new Error(`ファイルを読めません: ${path}`) };
	}

	let parsed: unknown;
	try {
		parsed = JSON.parse(text);
	} catch {
		return { ok: false, error: new Error(`JSON として読めません: ${path}`) };
	}

	if (!Array.isArray(parsed)) {
		return { ok: false, error: new Error("配列ではありません") };
	}

	const sales: Sale[] = [];
	for (let i = 0; i < parsed.length; i++) {
		const row: unknown = parsed[i];
		if (!isSale(row)) {
			return { ok: false, error: new Error(`${i} 件目の形式が不正です`) };
		}
		sales.push(row);
	}
	return { ok: true, value: sales };
}

function sumByProduct(sales: Sale[]): Map<string, number> {
	const out = new Map<string, number>();
	for (const s of sales) {
		out.set(s.product, (out.get(s.product) ?? 0) + s.amount);
	}
	return out;
}

const r = loadSales("sales.json");
if (!r.ok) {
	console.error(`エラー: ${r.error.message}`);
	process.exit(1);
}

for (const [product, total] of [...sumByProduct(r.value)].sort((a, b) => b[1] - a[1])) {
	console.log(`${product}: ${total} 円`);
}

const missing = loadSales("nothing.json");
console.log(missing.ok ? "読めた" : `想定どおり失敗: ${missing.error.message}`);

$ npx tsx step4.ts
ノート: 2000 円
ペン: 750 円
消しゴム: 150 円
想定どおり失敗: ファイルを読めません: nothing.json

配列でない JSON を渡すと、次のように止まります。

$ npx tsx step4.ts          # sales.json が { "not": "an array" } の場合
エラー: 配列ではありません

詰まりやすい箇所

発展課題

• 月別に集計する — date の先頭7文字（"2026-01"）でまとめる
• 単価を出す — amount / qty。qty が 0 のときの扱いを決める
• 検証を厳しくする — date が YYYY-MM-DD の形式か、amount が 0 以上かを確かめる
• ブランド型を使う — 検証済みの日付を ISODate 型にする（05）
• スキーマ検証ライブラリに置き換える — isSale を zod などで書き直し、手書きとの差を比べる