こんにちは！フロントエンドの現場で日々コードと格闘しているチーフアーキテクトです。
TypeScriptを学び始めると、「型ってなんだか窮屈だな……」と感じる瞬間があるかもしれませんね。特に「配列」は自由で便利なものなのに、なぜわざわざ「タプル」なんていう少し厳格なルールがあるんだろう？と不思議に思うのも当然です。
でも安心してください。タプルは、「中身が何かわかっているなら、もっと厳しく管理して安全を確保しよう」という、TypeScriptからの優しい気遣いなんです。
今日は、そんな「タプル型」という少し真面目な相棒について、お買い物の例えを使って紐解いていきましょう。
—
タプル型って、結局なに？
普通の配列（`number[]`など）が「同じ種類のアイテムを好きなだけ入れるカゴ」だとしたら、タプル型は「決まった場所に、決まったものだけを入れる『お弁当箱』」です。
お弁当箱を想像してみてください。
「左には卵焼き、真ん中には鮭、右にはブロッコリー」と決まっているからこそ、私たちは迷わず箸を伸ばせますよね？ もしそこに突然、消しゴムが入っていたら……「えっ？」ってなりますよね。
TypeScriptも同じなんです。「この配列の0番目には必ず『名前（string）』、1番目には必ず『年齢（number）』を入れる！」と約束することで、コードの事故を未然に防いでくれるんです。
タプルを定義してみよう
まずは、お買い物リストを例に書いてみます。
// 商品名（文字列）と価格（数値）だけが入る「お弁当箱」を作ります
// [string, number] と書くことで、順番と型を厳密に固定します
let product: [string, number] = [“特選りんご”, 200];
// もし順番を逆にしたり、違う型を入れると……？
// let errorProduct: [string, number] = [200, “特選りんご”];
// ↑ これを書くと、TypeScriptが「ダメですよ！」と真っ赤な波線で教えてくれます
どうでしょう？ `[string, number]` と書くことで、「最初が文字列、次が数字」というルールを定義できました。これだけで、プログラムが急に「何を扱っているか」を理解し始めます。
—
中身を取り出す「インデックスアクセス」
タプルの中身を取り出すのはとても簡単です。配列と同じように、`[0]` や `[1]` という番号（インデックス）を指定するだけです。
let userAccount: [string, number] = [“Tanaka”, 25];
// 0番目を取り出す（名前）
const userName = userAccount[0]; // “Tanaka” という文字列だと確定している
// 1番目を取り出す（年齢）
const userAge = userAccount[1]; // 25 という数値だと確定している
console.log(`${userName}さんは、今年で${userAge}歳ですね！`);
ここでの最大のメリットは、`userName` が「文字列だ」とTypeScriptが完璧に把握していることです。もしこれがただの配列なら、「中身が数字かもしれないし文字列かもしれないから、取り扱いに注意してね！」と常に疑う必要がありますが、タプルなら「名前が入っている」と確信を持ってコードが書けるんです。
—
つまずきやすいポイント：範囲外のアクセス
初心者の方がよくやってしまうのが、「定義していない場所」へのアクセスです。
let box: [string, number] = [“ペン”, 100];
// 0番目と1番目はあるけれど、2番目は存在しません！
// console.log(box[2]);
普通の配列なら「undefined」として許されることもありますが、タプルは「お弁当箱の仕切りは2つしかないよ！」というルールなので、存在しない場所を触ろうとするとTypeScriptが「そんな場所はないですよ」と警告してくれます。
これは一見厳しく見えますが、「存在しないデータをうっかり使ってエラーになる」というバグを、プログラムを動かす前に見つけ出せるということ。これぞTypeScriptの魔法です。
—
最後に：なぜタプルを使うのか？
現場では、例えば「APIから返ってくるデータ」や「関数の戻り値」などでよく使います。
「名前と年齢」のように、ペアで意味を持つデータを扱うとき、普通の配列だと「0番目が名前だっけ？1番目だっけ？」と混乱してしまいますよね。タプルを使うと、その「順番の約束」をコード自体が記憶してくれるので、チームでの開発が圧倒的に楽になります。
最初は少し窮屈に感じるかもしれませんが、それはあなたのコードが「より堅牢で、ミスが起きにくいプロフェッショナルな状態」に近づいている証拠です。
ぜひ、身の回りの「ペア」をタプルに当てはめて遊んでみてください。迷ったときは、いつでもこのお弁当箱のことを思い出してくださいね。応援しています！
コメント