TypeScript

.d.ts 파일 작성법

타입스크립트는 타입 추론을 통해 많은 타입 정보를 자동으로 얻어낼 수 있지만, 자바스크립트 코드(라이브러리, 프레임워크, 레거시 코드 등)를 타입스크립트 프로젝트에서 사용할 때는 타입 정보를 알 수 없는 경우가 발생합니다. 이럴 때 필요한 것이 바로 타입 선언 파일(Declaration Files), 즉 .d.ts 파일입니다.

.d.ts 파일이 자바스크립트 코드의 타입 표면을 어떻게 설명하고 보강하는지 확인합니다.

1

.d.ts 사용 기준

구현 파일이 JavaScript뿐이거나 외부 라이브러리가 타입을 제공하지 않을 때 .d.ts로 공개 API의 타입 표면을 보강합니다.

타입 선언 파일(Declaration Files)
2

.d.ts 파일의 기본 구조와 declare 키워드

.d.ts 파일은 .ts 파일과 거의 동일한 문법을 사용하지만, declare 키워드로 런타임 구현이 아니라 타입 선언만 제공한다는 뜻을 컴파일러에 알립니다.

.d.ts 파일
3

.d.ts 파일 작성 팁

외부에 노출되는 함수, 클래스, 상수만 선언하고 내부 helper까지 넓히지 않아야 구현 변화에 덜 흔들립니다.

설명서