Type Discovery

타입 정의 확보 경로

외부 라이브러리 타입은 자체 제공, @types, 직접 선언 순서로 찾으면 시행착오가 줄어든다.

타입을 찾는 우선순위

declaration

Package types

package.json의 types/typings 필드가 있으면 우선 사용한다.

@types

라이브러리가 타입을 안 주면 DefinitelyTyped 패키지를 찾는다.

Install

개발 의존성으로 설치해 컴파일 시 타입만 사용한다.

Custom d.ts

타입이 없거나 부족하면 필요한 범위만 선언한다.

typeRoots

커스텀 선언 경로를 컴파일러 검색 대상에 넣는다.

Version

런타임 라이브러리와 타입 패키지 버전을 맞춘다.

자체 타입@types 검색직접 선언설정 정리
선언 계약

타입 오류가 날 때는 코드보다 타입 파일의 출처를 먼저 확인한다. 같은 API라도 버전이 다르면 정의가 어긋난다.