HOWTO · TypeScript
Cómo extender un tipo en TypeScript
Aprenda cómo las interfaces de TypeScript extienden otras interfaces y cómo los alias de tipo componen formas de objetos.
En esta página
En TypeScript, use extends cuando una interfaz deba heredar los miembros de otra interfaz. Un type alias no puede usar esa forma de declaración, pero las formas de objetos se pueden componer con un intersection type mediante &. Los enfoques se solapan en muchas formas de objetos, pero no son idénticos: las interfaces admiten la fusión de declaraciones, mientras que las intersecciones combinan tipos y pueden producir una propiedad inutilizable cuando los miembros con el mismo nombre entran en conflicto.
Extender una interfaz en TypeScript
Una interfaz que extiende conserva los miembros base y añade sus propios requisitos. Por ejemplo, interface Project { submit(data: string): boolean; queue(data: string): boolean; } se puede extender con interface ProjectManagement extends Project { submitRequirements(data: string, id: number): boolean; }. Un valor de tipo ProjectManagement debe proporcionar los tres métodos. La palabra clave extends describe una relación entre interfaces; no proporciona implementaciones de métodos.
El siguiente ejemplo de JavaScript hace visible la forma de objeto resultante:
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
Este objeto de JavaScript demuestra las implementaciones de los tres métodos, pero JavaScript en sí no comprueba la interfaz de TypeScript. Si solo necesita combinar formas de objetos, un alias de tipo puede expresar un resultado similar: type ProjectManagement = Project & { submitRequirements(data: string, id: number): boolean; }. Prefiera la extensión de interfaces para un contrato de interfaz que pueda ampliarse o fusionarse; use una intersección cuando componga alias u otros tipos.
Extender varias interfaces en TypeScript
Una interfaz puede extender varias interfaces enumerando sus nombres después de extends, separados por comas. Por ejemplo, interface HasId { id: number; }, interface HasLabel { label: string; } e interface SelectableItem extends HasId, HasLabel { selected: boolean; } definen un contrato combinado con tres propiedades distintas. Un valor SelectableItem debe proporcionar id, label y selected.
Esto es útil cuando las capacidades definidas de forma independiente deben formar un único contrato de objeto. Si dos interfaces base declaran la misma propiedad con tipos incompatibles, TypeScript no puede formar a partir de ellas una interfaz de extensión válida. Alinee las declaraciones o elija un modelo diferente. Con los alias de tipo, las intersecciones también combinan miembros, pero los tipos de propiedad en conflicto pueden hacer que la propiedad resultante sea imposible de satisfacer en lugar de resolver el conflicto automáticamente.
Extender una clase con una interfaz en TypeScript
Una interfaz puede extender una clase y heredar sus miembros de instancia. Cuando la clase expone solo miembros públicos, una clase no relacionada puede implementar la interfaz resultante proporcionando la misma forma pública. Los miembros privados o protegidos añaden una restricción de origen: una clase que implementa debe heredar esos miembros de la clase nombrada en la cláusula extends de la interfaz.
Por ejemplo, class Key { private value = true; } seguido de interface Lock extends Key { enable(): void; } convierte el miembro privado de Key en parte del tipo de instancia requerido, aunque el código que usa Lock no pueda acceder a value. class FingerPrint extends Key implements Lock { enable(): void {} } es válido porque FingerPrint hereda ese miembro privado exacto de Key. Un class Unrelated implements Lock { enable(): void {} } no relacionado es rechazado: declarar un miembro privado separado con el mismo nombre no lo convierte en el miembro heredado de Key.
Use este patrón cuando la relación entre clases sea intencionada. Para un contrato solo público, implementar una interfaz directamente suele ser más sencillo. La extensión de interfaces comprueba la forma de instancia de la clase en tiempo de compilación; no copia la implementación de la clase en la interfaz ni en una clase que la implementa.