こんにちは！TypeScriptの型システムの世界へようこそ。
日々、フロントエンドからバックエンドまでコードを書いていると、「あれ、この関数の引数、なんだかガチガチに型を定義しすぎて使いにくくなっていないぞ？」と感じる瞬間はありませんか？
他のオブジェクト指向言語（JavaやC#など）からTypeScriptに入ってきた方ほど、「この関数には、このクラスやインターフェースをきっちり実装したオブジェクトしか渡せない」という思い込みを持ちがちです。
でも、TypeScriptの本質は「構造的型付け（Structural Typing）」にあります。ここをクリアすれば、TypeScriptの基本はバッチリマスターできますよ。今日は、引数の型定義をスマートにし、コードの結合度を劇的に下げるための極意を、優しく紐解いていきましょう！
—
1. ありがちな罠：「名前的型付け」の幻影と過剰な型定義
まずは、よくある「ちょっと窮屈なコード」を見てみましょう。
// ユーザー情報を表すインターフェースをしっかり定義しました
interface User {
id: number;
name: string;
email: string;
age: number;
createdAt: Date;
}
// ユーザーの名前だけを画面に表示するシンプルな関数
function printUserName(user: User): void {
console.log(`User Name: ${user.name}`);
}
一見、何の問題もない綺麗なコードに見えますよね。しかし、ここで少し現場を想像してみてください。
APIから取得した「名前（name）とID（id）しか入っていない軽量なオブジェクト」や、テスト用に用意したモックデータをこの `printUserName` に渡そうとしたとき、こう怒られます。
> 「エラー：型 ‘{{ id: number; name: string; }}’ の引数を型 ‘User’ のパラメータに割り当てることはできません。プロパティ ‘email’, ‘age’, ‘createdAt’ がありません」
「いやいや！名前を表示するだけなんだから、`email` も `age` も要らないでしょう！」と思いませんか？これが、過剰な型定義が生む弊害です。関数が「本当は必要としていないプロパティ」まで要求してしまうため、コードの再利用性がガタガタになってしまいます。
—
2. 救世主：「構造的型付け（Structural Typing）」とは？
ここでTypeScriptの心臓部である「構造的型付け（別名：ダックタイピング）」が登場します。
Javaなどの名前にこだわる世界（Nominal Typing）とは違い、TypeScriptはこう考えます。
> 「もしそれがアバターのように歩き、アバターのようにガーガー鳴くなら、それはアバター（必要な構造を持っている）とみなそう」
つまり、関数が必要とする最小限のプロパティさえ持っていれば、元のオブジェクトがどんなデカいインターフェースから作られていようと、関係なく受け入れることができるのです。
必要なプロパティだけを引数に直撃させる
先ほどのコードを、構造的型付けを活かして書き換えてみましょう。
// ① 関数が本当に必要としている「構造」だけをその場で（あるいは個別に）定義する
function printUserName(user: { name: string }): void {
console.log(`User Name: ${user.name}`);
}
// 巨大なUserオブジェクト
const complexUser = {
id: 1,
name: ‘Taro Engineer’,
email: ‘taro@example.com’,
age: 28,
createdAt: new Date(),
};
// 全く関係ない、名前だけの簡易的なオブジェクト
const simpleUser = {
name: ‘Jiro Shachiku’,
};
// どちらも問題なくコンパイルを通過し、実行できます！
printUserName(complexUser); // 出力: User Name: Taro Engineer
printUserName(simpleUser); // 出力: User Name: Jiro Shachiku
すごいですね！ `printUserName` は `complexUser` も `simpleUser` も、両方とも「`name` という文字列プロパティを持っている」という共通の構造（Structure）を満たしているため、喜んで受け入れます。
—
3. インターフェースを使う場合のスマートなアプローチ
「そうは言っても、毎回インラインで `{ name: string }` と書くのはメンテナンス性が悪いし、ちゃんとした名前（インターフェース）をつけたい」という場面もありますよね。
そんなときは、インターフェースの継承や、必要な部分だけを切り出すユーティリティ型を活用します。
interface User {
id: number;
name: string;
email: string;
age: number;
createdAt: Date;
}
// パターンA：表示用に特化した小さなインターフェースを別途作る
interface Nameable {
name: string;
}
function printUserNameSafe(user: Nameable): void {
console.log(`User Name: ${user.name}`);
}
あるいは、TypeScriptの強力な組み込み型である `Pick` を使えば、既存の型から必要な部分だけをエレガントに抽出することも可能です。
// User型から ‘name’ だけを摘み食い（Pick）する！
function printUserNameWithPick(user: Pick
console.log(`User Name: ${user.name}`);
}
これなら、「元の `User` 型の定義が変わって `name` が `fullName` に変わった！」というときも、TypeScriptのコンパイラが「おい、Pickしているプロパティ名も変えろよ」と全方向から教えてくれます。保守性と柔軟性のいいとこ取りですね。
—
4. 陥りやすい罠：オブジェクトリテラルの「余剰プロパティチェック」
ここで、構造的型付けを学んだ初心者がよくハマる「ちょっとした罠」についても触れておきましょう。
以下のコードを見てください。
function printUserName(user: { name: string }): void {
console.log(`User Name: ${user.name}`);
}
// これは通ります
printUserName({ name: ‘Taro’, age: 25 }); // あれ？エラーにならない？
……おっと、実はこれはTypeScriptの「オブジェクトリテラルに対する余剰プロパティチェック（Excess Property Checking）」という特別なルールが働いています。
直接オブジェクトの形（ `{ name: ‘Taro’, age: 25 }` ）を関数の引数に突っ込んだ場合、TypeScriptは「おいおい、受け取り側は `name` しか求めていないのに、余計な `age` が混ざってるぞ。タイポ（入力ミス）じゃないのか？」と優しく（厳しく？）検知してエラーにしてくれます。
変数を経由すると構造的型付けが全開になる
しかし、一度変数に代入してから渡すと、この余剰プロパティチェックはバイパスされ、純粋な構造的型付けの世界になります。
const rawData = { name: ‘Taro’, age: 25, role: ‘admin’ };
// 変数経由なら、余分なプロパティがあってもエラーにならない！
// （nameさえあれば、関数側は満足するため）
printUserName(rawData);
「直接書くとエラーになるのに、変数に入れると通るの？バグじゃない？」と混乱しがちですが、これは「直書きのタイポを防ぎつつ、動的なデータのやり取りでは柔軟性を担保する」というTypeScriptの素晴らしい設計思想の表れです。
—
まとめ：関数の引数は「引き算」で考えよう
オブジェクト指向言語の感覚だと、どうしても「このクラスを継承した完全な形を渡さなきゃ」と足し算で型を考えがちになります。
しかし、TypeScriptで関数を設計するときは、こう考えてみてください。
> 「この関数は、引数のオブジェクトの『どこ』に触りたいんだっけ？」
触りたいプロパティだけをピンポイントで要求する（あるいは `Pick` や部分的なインターフェースを使う）。これだけで、あなたの書くコードは驚くほどモジュール性が高く、テストしやすく、変更に強いものに生まれ変わります。
ここをクリアできれば、TypeScriptの型システムと本当に「分かり合えた」と言えますよ。
日々のコーディングで、ぜひ「構造的型付けの美しさ」を実感してみてくださいね！