[코드잇 스프린트 풀스택 4기] .d.ts 타입 정의 파일이란?

.d.ts 타입 정의 파일?

.d.ts 파일은 TypeScript에서 "Declaration File"로 불리며, JavaScript 라이브러리나 기존 코드의 타입 정보를 정의하기 위한 파일이다. 이 파일들은 실제 코드 구현을 포함하지 않고, 오직 타입 선언만 제공하여 TypeScript 컴파일러가 해당 라이브러리나 모듈의 구조와 인터페이스를 이해할 수 있게 도와준다. 이를 통해 타입 안전성을 확보하고, 자동 완성 및 타입 검사를 강화할 수 있다.

 

.d.ts 파일의 역할

• 타입 선언 제공:
  JavaScript 라이브러리나 기존 코드에 대해 함수, 변수, 클래스, 인터페이스 등의 타입 정보를 명시
• 타입 안전성 강화:
  TypeScript 컴파일러는 .d.ts 파일을 참조하여 타입 검사를 수행하므로, 타입 관련 오류를 미리 발견
• 개발 도구 지원:
  IDE나 편집기는 .d.ts 파일을 활용하여 코드 자동 완성, 인텔리센스, 문서화 등의 기능을 제공

 

.d.ts 파일 생성 방법

수동 작성

• 직접 작성:
  개발자가 직접 필요한 타입 정보를 선언하여 .d.ts 파일을 생성
• 예를 들어, 라이브러리의 API를 사용할 때 해당 라이브러리의 함수, 클래스, 객체 등이 어떻게 구성되어 있는지 정의할 수 있음

// example-library.d.ts
declare module "example-library" {
  export function greet(name: string): string;
  export interface User {
    id: number;
    name: string;
  }
}

자동 생성

• 컴파일러 옵션 활용:
  만약 TypeScript로 작성된 코드를 배포하는 경우, tsc --declaration 옵션을 사용하면 컴파일 시 자동으로 .d.ts 파일을 생성
• 이 옵션은 코드의 타입 정보를 기반으로 선언 파일을 생성

도구 활용

• 타입 선언 생성 도구:
  dts-gen과 같은 도구를 사용하면, 기존 JavaScript 코드나 라이브러리를 위한 기본적인 .d.ts 파일의 스켈레톤을 생성한 후, 이를 바탕으로 세부적인 타입 정보를 추가할 수 있음