이번에는 자바스크립트로 작성된 라이브러리를 타입스크립트로 사용하기 위해 타입 정의 파일을 추가하는 방법에 대해 알아보겠습니다.

1. DefinitelyTyped 검색

가장 먼저 공식 DefinitelyTyped 웹사이트나 npm에서 원하는 라이브러리의 타입 정의 파일을 검색합니다. 만약 없다면, 직접 만들어야 합니다.

2. @types 패키지 설치

일반적으로, 타입스크립트는 @types 패키지를 사용하여 외부 라이브러리의 타입 정의를 제공합니다. 원하는 라이브러리가 lodash 일 경우, @types/lodash를 npm을 통해 설치합니다.

npm install @types/lodash --save-dev

만약 타입 정의 파일이 없다면, 직접 만들어야 합니다.

3. 커스텀 타입 정의 파일 생성

타입스크립트에서는 .d.ts 확장자를 가진 파일을 사용하여 커스텀 타입 정의를 생성할 수 있습니다.

// custom.d.ts
declare module 'my-library' {
  function myFunction(value: string): void;
  let myVariable: number;
}

그 후, 해당 파일을 프로젝트에 추가하고 타입 정의를 작성합니다.

4. tsconfig.json 설정

마지막으로, tsconfig.json 파일에서 include 속성을 설정하여 커스텀 타입 정의 파일이 포함되도록 합니다.

{
  "compilerOptions": {
    // 설정 값
  },
  "include": [
    "src",
    "custom.d.ts"
  ]
}

이제 자바스크립트 라이브러리를 타입스크립트로 쉽게 사용할 수 있게 되었습니다.

위 방법을 통해 타입스크립트로 자바스크립트 라이브러리를 변환하는 방법에 대해 알아보았습니다. 이제 이를 활용하여 프로젝트에서 타입스크립트를 보다 안정적으로 사용할 수 있을 것입니다.

참고 자료

• DefinitelyTyped
• 타입스크립트 핸드북