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