HOWTO · TypeScript

TypeScript で型を拡張する方法

TypeScript のインターフェースが他のインターフェースを拡張する方法と、型エイリアスがオブジェクトの形状を合成する方法を学びます。

このページの内容

TypeScript では、あるインターフェースが別のインターフェースのメンバーを継承すべき場合に extends を使用します。type alias はその宣言形式を使用できませんが、オブジェクトの形状は & を使った intersection type で合成できます。両アプローチは多くのオブジェクト形状で重なりますが、同一ではありません。インターフェースは宣言のマージをサポートする一方、インターセクションは型を組み合わせ、同名メンバーが競合すると使用できないプロパティを生むことがあります。

TypeScript でインターフェースを拡張する

拡張するインターフェースは、ベースのメンバーを保持し、独自の要件を追加します。たとえば、interface Project { submit(data: string): boolean; queue(data: string): boolean; } は interface ProjectManagement extends Project { submitRequirements(data: string, id: number): boolean; } で拡張できます。ProjectManagement 型の値は、3 つのメソッドすべてを提供しなければなりません。extends キーワードはインターフェース間の関係を記述するものであり、メソッドの実装を提供するものではありません。

次の JavaScript の例は、結果として得られるオブジェクトの形状を示しています。

const projectManagement = {
  submit(data) {
    return data.length > 0;
  },
  queue(data) {
    return data.length > 0;
  },
  submitRequirements(data, id) {
    return data.length > 0 && id > 0;
  },
};

console.log(projectManagement.submitRequirements("Roadmap", 7));
true

この JavaScript オブジェクトは 3 つのメソッドの実装を示していますが、JavaScript 自体は TypeScript のインターフェースをチェックしません。オブジェクトの形状を組み合わせるだけなら、型エイリアスでも同様の結果を type ProjectManagement = Project & { submitRequirements(data: string, id: number): boolean; } と表現できます。拡張やマージの可能性があるインターフェースの契約にはインターフェースの拡張を優先し、エイリアスやその他の型を合成する場合はインターセクションを使用してください。

TypeScript で複数のインターフェースを拡張する

インターフェースは、extends の後に名前をカンマで区切って列挙することで、複数のインターフェースを拡張できます。たとえば、interface HasId { id: number; }、interface HasLabel { label: string; }、interface SelectableItem extends HasId, HasLabel { selected: boolean; } は、3 つの異なるプロパティを持つ複合的な契約を定義します。SelectableItem の値は、id、label、selected を提供しなければなりません。

これは、独立に定義された機能が 1 つのオブジェクト契約を形成する必要がある場合に役立ちます。2 つのベースインターフェースが同じプロパティを互換性のない型で宣言している場合、TypeScript はそれらから有効な拡張インターフェースを形成できません。宣言を揃えるか、別のモデルを選択してください。型エイリアスでは、インターセクションもメンバーを組み合わせますが、競合するプロパティ型は、競合を自動的に解決するのではなく、結果のプロパティを満たせなくすることがあります。

TypeScript でインターフェースを使ってクラスを拡張する

インターフェースはクラスを拡張し、そのインスタンスメンバーを継承できます。クラスがパブリックメンバーのみを公開している場合、無関係なクラスでも同じパブリックな形状を提供することで、結果のインターフェースを実装できます。プライベートメンバーやプロテクトメンバーは、起源に関する制約を追加します。実装するクラスは、それらのメンバーを、インターフェースの extends 句で指定されたクラスから継承しなければなりません。

たとえば、class Key { private value = true; } に続けて interface Lock extends Key { enable(): void; } とすると、Lock を使用するコードは value にアクセスできないにもかかわらず、Key のプライベートメンバーが必須のインスタンス型の一部となります。class FingerPrint extends Key implements Lock { enable(): void {} } は、FingerPrint がまさにそのプライベートメンバーを Key から継承しているため有効です。一方、無関係な class Unrelated implements Lock { enable(): void {} } は拒否されます。同名のプライベートメンバーを別途宣言しても、それが Key から継承したメンバーになるわけではありません。

このパターンは、クラスの関係が意図的な場合に使用してください。パブリックのみの契約では、インターフェースを直接実装する方が通常は簡単です。インターフェースの拡張は、コンパイル時にクラスのインスタンス形状をチェックします。クラスの実装をインターフェースや実装クラスにコピーするものではありません。