← Back to NOTES 🌰 ← Back to Effective TypeScript

← 아이템 35 - 데이터가 아닌, API와 명세를 보고 타입 만들기

핵심 요약

코드로 표현하고자 하는 모든 분야에는 주제를 설명하기 위한 전문 용어들이 이미 존재한다. 자체적으로 용어를 만들어 내려고 하지 말고, 해당 분야에서 이미 존재하는 단어들을 사용해야 한다. 이런 용어들을 사용하면 소통에 유리하고 더욱 명확한 코드 작성이 가능하다.

자세한 내용

모호한 타입 명명의 문제점

잘못된 타입 명명은 코드의 의도를 불명확하게 만든다.

초기 Animal 인터페이스의 문제:

  1. name: 매우 일반적인 용어, 학명인지 일반적 명칭인지 알 수 없음
  2. endangered: boolean 값으로 멸종을 표현하는데, true가 멸종된 동물인지, false가 멸종인지 모호함
  3. habitat: 서식지를 나타내기 위해 사용했지만 불분명하고, 너무 범위가 넓은 string 타입

결과: 속성에 대한 정보가 모호하기 때문에 작성자에게 의도를 물어보아야 함

해결 방법: 분야별 전문 용어 사용

name 개선: 더 구체적인 용어로 대체

endangered 개선: 동물 보호 등급 표준 사용