【入門編】引数に渡す「クラスのコンストラクタ」を型定義し、ファクトリ関数を安全に実装する – TypeScript コア・型システムの基礎解析バイブル

こんにちは!フロントエンドからバックエンドまで、TypeScriptの荒波を一緒に航海するシニアアーキテクトの私です。

今回は、TypeScriptの型システムにおける「クラスのコンストラクタ(設計図の生成元)をどう型安全に扱うか」という、実務で非常によく遭遇するテーマを紐解いていきます。

「クラスを引数に取る関数を作りたいけれど、どんな型を書けばいいのか分からない……」
「`any`型に逃げたくないけれど、コンストラクターの型定義って難しそう……」

そんなモヤモヤを抱えていませんか?大丈夫です。ここをクリアすれば、TypeScriptの型システムがぐっと身近になり、あなたのコードの安全性は劇的に跳ね上がります。一緒に一歩ずつ、本質をマスターしていきましょう!

—

1. なぜ「クラスのコンストラクタ」を型定義する必要があるのか?

JavaScriptやTypeScriptにおいて、クラスは「インスタンス(実体)を作るための設計図」ですよね。例えば、次のような状況を想像してください。

「ある特定のインターフェース(共通のルール)を満たしているクラスなら、なんでも受け取って、内部でよしなにインスタンスを生成してくれる『ファクトリ関数(工場関数)』を作りたい」

このとき、引数に「インスタンスそのもの」ではなく、「クラスのコンストラクタ(`new`をつけて呼び出すもの)」を渡す必要があります。

[ファクトリ関数] ──(クラスのコンストラクタを渡す)──> [内部で new する] ──> [安全にインスタンスを返却]

この「クラスそのもの」を型としてどう表現するのか? ここにTypeScriptの型システムの美しさが隠されています。

—

2. 基本的なアプローチ:`new (…) => T` 構文の正体

TypeScriptで「コンストラクタ関数」を表現するには、シグネチャ(Call/Construct Signature)という特殊な構文を使います。

百聞は一見に如かず、実際のコードを見てみましょう。

// 1. すべての乗り物が満たすべきインターフェース
interface Vehicle {
drive(): void;
}

// 2. 「コンストラクタ型」の定義
// 「new (…) で Vehicle を返すもの」という意味になります。
type VehicleConstructor = new (…args: any[]) => Vehicle;

// 3. ファクトリ関数の実装
function createVehicle(ctor: VehicleConstructor): Vehicle {
// ここで安全に new できる!
return new ctor();
}

コードの深掘り解説

  • `…args: any[]`

これは「どんな引数の数・型であっても受け入れられる可変長引数」を意味しています。コンストラクタが引数(例: `name: string`など)を取る場合があるため、このように汎用的に構えておくのが実用的です。

  • `=> Vehicle`

このコンストラクタを使って `new` した結果、最終的に `Vehicle` インターフェースを実装したオブジェクトが返ってくることを保証しています。

—

3. 実践!引数を持つクラスとジェネクスティクスの組み合わせ

先ほどのコードでは引数なしのコンストラクタを想定していましたが、実際の現場では、クラスのコンストラクタにパラメータを渡したいことがほとんどですよね。

ここで、TypeScriptの真骨頂であるジェネリクス(Generics)を組み合わせて、より柔軟かつ厳密なファクトリ関数に進化させてみましょう。

// 共通のインターフェース
interface Character {
name: string;
attack(): void;
}

// 戦士クラス
class Warrior implements Character {
constructor(public name: string, private weapon: string) {}

attack() {
console.log(`${this.name}は ${this.weapon} で攻撃した!`);
}
}

// 魔法使いクラス
class Mage implements Character {
constructor(public name: string, private spell: string) {}

attack() {
console.log(`${this.name}は ${this.spell} を唱えた!`);
}
}

/

  • ジェネリクスを使った神ファクトリ関数
  • T : 生成されるインスタンスの型(Characterを実装したもの)
  • A : コンストラクタに渡す引数の型タプル

/
function summonCharacter(
ctor: new (…args: A) => T,
…args: A
): T {
// コンストラクタに必要な引数をそのまま渡してインスタンス化
return new ctor(…args);
}

// — 使用例 —

// 1. 戦士を召喚(コンストラクタ引数 “アーサー”, “エクスカリバー” が型チェックされる)
const warrior = summonCharacter(Warrior, “アーサー”, “エクスカリバー”);
warrior.attack(); // 実行結果: アーサーは エクスカリバー で攻撃した!

// 2. 魔法使いを召喚
const mage = summonCharacter(Mage, “マーリン”, “ファイアボール”);
mage.attack(); // 実行結果: マーリンは ファイアボール を唱えた!

ここがプロの技:型推論の魔法

この `summonCharacter` 関数は、第一引数に渡したクラス (`Warrior` や `Mage`) を見て、第二引数以降 (`…args: A`) の型を自動的に推論してくれます。

もし、`Warrior` なのに存在しない引数を渡したり、型違いの引数を渡したりすると……?
コンパイラが即座に赤く波線を引き、バグを未然に防いでくれます。これがTypeScriptの圧倒的な強みです。

—

4. 初学者が陥りがちな文法エラーとアンチパターン

型定義の学習中によくやってしまう間違いをいくつかピックアップしておきます。これらを避けるだけで、コードの質がワンランク上がります。

❌ やりがちエラー 1: `typeof` を忘れてクラス自体ではなくインスタンスを指定してしまう

// 間違い
function badFactory(ctor: Vehicle) { // これだと「インスタンスそのもの」を要求してしまう
return new ctor(); // 🔴 エラー: “this expression is not constructable”
}

// 正解
function goodFactory(ctor: new () => Vehicle) { // クラスの型(コンストラクタ型)にする
return new ctor(); // 🟢 完璧!
}

> 解説: TypeScriptで「クラスそのもの(設計図)」を型として指定したい場合は、`typeof ClassName` と書くか、今回紹介した `new (…) => T` というコンストラクタシグネチャを使用します。

❌ アンチパターン 2: すべてを `any` で片付ける

// 動くには動くが、型安全性が完全に崩壊する手抜きコード
function lazyFactory(ctor: any, …args: any[]): any {
return new ctor(…args);
}

> 解説: これではTypeScriptを使っている意味がありません。どこからでも変なクラスが渡せてしまい、実行時エラーの温床になります。必ず `new (…) => T` やジェネリクスを使って境界線を守りましょう。

—

まとめ:ここをクリアすればTypeScriptの基本はバッチリ!

今回は、クラスのコンストラクタを型定義し、安全なファクトリ関数を実装する方法を解説しました。

1. コンストラクタシグネチャ (`new (…) => T`) を使って「クラスそのもの」を型として表現する。
2. ジェネリクス (``) を組み合わせることで、引数の型や戻り値の型を完全に連動・推論させる。
3. `any` に逃げず、コンパイラに型安全性を担保してもらう。

このパターンは、フレームワークの内部実装や、DI(依存性注入)コンテナ、プラグインシステムなど、高度なアーキテクチャの至る所で使われています。

ここをマスターしたあなたなら、もうTypeScriptの型システムを恐れる必要はありません。ぜひ明日の開発から、自信を持ってこのテクニックを使ってみてくださいね!

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