외부 모듈(라이브러리)을 사용할 때 해당 모듈의 타입을 지정하려면 몇 가지 방법을 사용할 수 있습니다. 여러분은 이러한 방법을 사용하여 외부 모듈의 타입을 정의하고 TypeScript 코드에서 해당 모듈을 더 안전하게 사용할 수 있습니다.
1. Ambient 모듈 선언
Ambient 모듈 선언은 .d.ts 확장자를 가진 파일에 타입 선언을 작성하여 외부 모듈의 타입 정보를 제공하는 방법입니다. 이 방법은 주로 DefinitelyTyped 프로젝트에서 외부 라이브러리의 타입 정의를 관리하는 데 사용됩니다.
예를 들어, lodash 라이브러리의 타입을 사용하려면 lodash.d.ts 파일을 생성하고 다음과 같이 타입 선언을 작성할 수 있습니다.
// lodash.d.ts
declare module 'lodash' {
// 타입 선언 작성
}
2. 타입 정의 파일 설치
일부 외부 라이브러리는 @types 스코프 하에 타입 정의 파일을 제공합니다. 이러한 타입 정의 파일은 @types 패키지에 포함되어 있으며, 외부 라이브러리를 설치한 후에 별도의 타입 정의 파일을 설치할 필요가 없습니다.
예를 들어, axios 라이브러리에 대한 타입을 사용하려면 다음과 같이 @types/axios 패키지를 설치할 수 있습니다.
npm install @types/axios --save-dev
3. /// <reference> 지시문 사용
/// <reference> 지시문을 사용하여 타입 정의 파일을 참조할 수도 있습니다. 이 방법은 독립적으로 작성된 타입 정의 파일을 TypeScript 파일 안에서 명시적으로 참조할 때 사용됩니다.
예를 들어, custom.d.ts 파일에 정의된 타입을 사용하려면 TypeScript 파일 상단에 다음과 같이 /// <reference> 지시문을 추가할 수 있습니다.
/// <reference path="custom.d.ts" />
이러한 방법을 사용하여 외부 모듈의 타입을 선언할 수 있습니다. 이를 통해 TypeScript에서 외부 모듈을 더 안전하게 사용할 수 있으며, 타입 에러를 줄일 수 있습니다.