TypeScript

.d.ts 파일 작성법

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

타입 선언 파일와 .d.ts 파일를 중심으로 .d.ts 파일 작성법의 판단 흐름을 읽습니다.

1

왜 .d.ts 파일이 필요한가?

.d.ts 파일이 필요한 주요 이유는 다음과 같습니다.

타입 선언 파일(Declaration Files)
2

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

.d.ts 파일은 .ts 파일과 거의 동일한 문법을 사용하지만, declare 키워드를 사용하여 이것은 실제 구현이 아니라, 단지 타입 정보임을 선언하는 것을 명시합니다.

.d.ts 파일
3

.d.ts 파일 작성 팁

필요한 타입만 선언: .d.ts 파일은 실제 구현 코드를 포함하지 않으므로, 자바스크립트 코드가 외부에 노출하는 멤버들만 선언하면 됩니다.

설명서