타입 선언 파일 작성 및 사용

타입 선언 파일은 자바스크립트 유틸리티를 안전한 API로 감쌉니다

기존 JS 파일의 함수와 객체에 .d.ts를 붙이면 구현을 바꾸지 않고도 TypeScript 프로젝트에서 타입 검사를 받을 수 있습니다.

시나리오

JS 유틸 분석

이미 있는 함수가 어떤 인자를 받고 어떤 값을 반환하는지 실행 코드와 호출부에서 확인합니다.

utils.js
선언 작성

API 모양 기록

같은 이름의 .d.ts 파일에 함수, 타입, 모듈 내보내기 형태를 선언합니다.

utils.d.ts
사용 확인

호출부 타입 검사

TypeScript 파일에서 import 후 자동완성과 잘못된 인자 오류가 나타나는지 확인합니다.

import
배포

패키지 타입 노출

라이브러리라면 package.json의 types 필드로 선언 파일 진입점을 가리킵니다.

types