중급 TypeScript - 타입 선언: 외부 모듈 선언

타입 선언: 외부 모듈 선언

타입스크립트는 자바스크립트의 상위 집합으로서, 정적 타입을 제공하여 코드의 안전성과 가독성을 높이는 데 도움을 줍니다. 외부 모듈은 다른 파일이나 라이브러리에서 정의된 코드로, 이를 사용하기 위해서는 해당 모듈의 타입 정보를 명확히 해줘야 합니다. 이 과정이 바로 외부 모듈 선언입니다.

외부 모듈이란?

외부 모듈은 일반적으로 다음과 같은 상황에서 사용됩니다:

  • 제3자 라이브러리: npm 패키지와 같이 이미 작성된 코드를 가져올 때
  • 다른 소스 파일: 프로젝트 내 다른 TypeScript 또는 JavaScript 파일에서 정의한 코드

외부 모듈 선언 방법

  • 모듈 이름 지정

    • declare module 구문을 사용하여 특정 이름의 모듈을 선언합니다.
  • 타입 정의

    • 해당 모듈 내에 포함될 변수, 함수 및 클래스 등의 타입을 정의합니다.

예를 들어, myLibrary라는 제3자 라이브러리를 사용할 경우, 다음과 같이 외부 모듈을 선언할 수 있습니다:

// myLibrary.d.ts
declare module 'myLibrary' {
    export function greet(name: string): string;
    export const version: number;
}

위 예제에서는 greet이라는 함수를 문자열 매개변수와 함께 받아들이고 문자열 반환값을 가지며, 또한 version이라는 숫자형 상수를 내보내는 것을 정의했습니다.

실제 사용 예시

이제 위에서 선언한 myLibrary를 사용하는 방법은 다음과 같습니다:

// app.ts
import { greet, version } from 'myLibrary';

const message = greet('Alice');
console.log(message); // "Hello Alice"
console.log(`Version: ${version}`); // "Version: 1.0"

이렇게 하면 TypeScript는 컴파일 시점에 올바른 타입 체크를 수행하고 개발자는 더 안전하게 코드를 작성할 수 있습니다.

결론

외부 모듈 선언은 TypeScript 프로젝트에서 중요한 역할을 하며, 특히 제3자 라이브러리를 사용할 때 필수적입니다. 이를 통해 각종 기능들을 손쉽게 활용하면서도 강력한 정적 타이핑 시스템 덕분에 오류를 줄일 수 있습니다. 이러한 방식으로 작업하면 팀원 간 협업 시에도 일관성 있는 코드 작성을 도울 수 있습니다.

Subscribe to shimdh.log

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
jamie@example.com
Subscribe