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 타입의 값은 세 가지 메서드를 모두 제공해야 합니다. 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 객체는 세 가지 메서드 구현을 보여 주지만, 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; }는 서로 다른 세 가지 속성을 가진 결합된 계약을 정의합니다. SelectableItem 값은 id, label, selected를 제공해야 합니다.

이는 독립적으로 정의된 기능들이 하나의 객체 계약을 이루어야 할 때 유용합니다. 두 기본 인터페이스가 같은 속성을 호환되지 않는 타입으로 선언하면 TypeScript는 그것들로 유효한 확장 인터페이스를 만들 수 없습니다. 선언을 맞추거나 다른 모델을 선택하세요. 타입 별칭에서 인터섹션도 멤버를 결합하지만, 충돌하는 속성 타입은 충돌을 자동으로 해결하는 대신 결과 속성을 충족할 수 없게 만들 수 있습니다.

TypeScript에서 인터페이스로 클래스 확장하기

인터페이스는 클래스를 확장하고 그 인스턴스 멤버를 상속할 수 있습니다. 클래스가 공개 멤버만 노출하는 경우, 관련 없는 클래스도 동일한 공개 형태를 제공함으로써 결과 인터페이스를 구현할 수 있습니다. private 또는 protected 멤버는 출처 제약을 추가합니다. 구현하는 클래스는 해당 멤버들을 인터페이스의 extends 절에 명명된 클래스로부터 상속해야 합니다.

예를 들어 class Key { private value = true; } 뒤에 interface Lock extends Key { enable(): void; }가 오면, Lock을 사용하는 코드는 value에 접근할 수 없음에도 Key의 private 멤버가 필요한 인스턴스 타입의 일부가 됩니다. class FingerPrint extends Key implements Lock { enable(): void {} }는 FingerPrint가 바로 그 private 멤버를 Key로부터 상속하므로 유효합니다. 반면 관련 없는 class Unrelated implements Lock { enable(): void {} }는 거부됩니다. 같은 이름의 별도 private 멤버를 선언한다고 해서 그것이 Key로부터 상속한 멤버가 되지는 않습니다.

이 패턴은 클래스 관계가 의도적인 경우에 사용하세요. 공개 전용 계약에서는 인터페이스를 직접 구현하는 것이 보통 더 간단합니다. 인터페이스 확장은 컴파일 시점에 클래스의 인스턴스 형태를 검사합니다. 클래스의 구현을 인터페이스나 구현 클래스에 복사하지는 않습니다.