d.ts란 무엇인가?

• 타입 추론을 돕는 파일이다.
• 변수나 함수에 대한 타입을 선언하여, import 없이 사용할 수 있게 해준다.
• d.ts를 사용하여 TypeScript를 generating 할 수 있다.
• 선언부만 존재하며, 구현부는 존재하지 않는다.
• 이미 만들어진 프로젝트에 TypeScript를 추가 할 수 있는 방법이다.
  • 리액트와 같은 프로젝트를 generating 할 때, @types/ 가 붙은 커맨드가 사용되는 이유이다.
  • 해당 명령어를 사용하면 node_modules/types 에 d.ts 가 생성된다.

Axios 깃허브의 index.d.ts 를 확인하면, 어떤 식으로 타입스크립트가 인터페이스로 구성되어 사용 되고 있는 지 확인 할 수 있다. 이 d.ts 파일 덕분에, 타입스크립트로 작성되지 않은 라이브러리도 타입을 붙여 사용할 수 있게 되는 것이다.

axios/index.d.ts at master · axios/axios

Jquery와 같이 인기 많은 자바스크립트 기반의 라이브러리는 여러 사람들이 index.t.js를 만드는데 기여하고 있는 것을 볼수 있다.

Jquery와 같이 인기 많은 자바스크립트 기반의 라이브러리는 여러 사람들이 index.t.js를 만드는데 기여하고 있는 것을 볼수 있다.

DefinitelyTyped/index.d.ts at master · DefinitelyTyped/DefinitelyTyped

샘플링해보기

• 공식 문서에는 TypeSript play ground가 존재하는데 이곳에서 생성 해 볼 수 있다.

  (이곳에서 JsDoc도 지원한다.)

  • 하나하나 quick fix를 통해 generating 할 수 있다.
  • jsDoc 기반으로 작성된 코드가 TypeScript로 어느 정도로 호환되어 치환 될 지 확인 가능하다.