DIL: 이펙티브 타입스크립트

스터디: 월간 CS, https://github.com/monthly-cs/2024-05-effective-typescript
작성일: 2024-06-11
작성자: dusunax

---

아이템 47: 공개 API에 등장하는 모든 타입을 익스포트하기

• 서드파티 모듈에서 익스포트 되지 않은 타입 정보가 필요한 경우, 타입간 매핑 도구를 사용해서 참조하는 방법을 찾을 수 있다.
• 라이브러리 제작자는 프로젝트 초기에 타입 익스포트를 작성해야 한다.
  • 함수 선언에 타입 정보가 있다? 타입 정보가 export 되고 있는 것

interface SecretName {
  first: string;
  last: string;
}

interface SecretSanta {
  name: SecretName;
  gift: string;
}

export function getGift(name: SecretName, gift: string): SecretSanta {
  // 함수만 export
  // ...
}

• 함수 시그니처에서 타입을 추출해낼 수 있다.
  • Parameters, ReturnType 제너릭

type MySanta = ReturnType<typeof getGift>; // 리턴 타입
//   ^? type MySanta = SecretSanta
type MyName = Parameters<typeof getGift>[0]; // 파라미터
//   ^? type MyName = SecretName

Things to Remember

• Export types that appear in any form in any public method. Your users will be able to extract them anyway, so you may as well make it easy for them.
  • 공개 메서드의 타입을 export하자. 어차피 추출할 수 있으므로, 사용자가 사용하기 쉽게 만드는 것이 좋다.