타입 선언 소비하기

타입 선언 파일을 내 코드에서 쓰려면 어떻게 하면 될까요? 사실 npm만 있으면 되고, 특별한 도구는 전혀 필요 없어요. 이 문서에서는 라이브러리를 받아 쓰기만 하면 되는 @types 패키지의 세계를 가장 간단한 형태로 보여줄게요.

출처: TypeScript 공식문서

본문

타입 선언을 가져오는 데는 npm 말고 다른 도구가 필요 없어요. 예를 들어 lodash 같은 라이브러리의 선언 파일을 받는 건 아래 명령 하나면 끝나요.

npm install --save-dev @types/lodash

한 가지 짚고 넘어갈 점이 있어요. npm 패키지가 Publishing에서 설명한 것처럼 자기 패키지에 이미 선언 파일을 담고 있다면, 별도로 @types 패키지를 받을 필요는 없어요.

이제부터는 번거로움 없이 TypeScript 코드에서 lodash를 쓸 수 있어요. 이 방식은 모듈 코드에서도, 전역 코드에서도 똑같이 동작하죠.

예를 들어 타입 선언을 npm install로 받아둔 다음엔, 모듈을 쓰는 코드에서는 import를 해서 이렇게 작성하면 돼요.

import * as _ from "lodash";
_.padStart("Hello TypeScript!", 20, " ");

만약 모듈을 쓰지 않는 코드라면, 전역 변수 _를 그냥 직접 사용하면 돼요.

_.padStart("Hello TypeScript!", 20, " ");

대부분의 경우 타입 선언 패키지는 npm 패키지 이름과 항상 같고, 다만 @types/ 접두사가 붙어요. 그래도 혹시 직접 찾아봐야 할 때는 Yarn package search로 좋아하는 라이브러리의 패키지를 찾아보면 돼요.

참고: 찾고 있는 선언 파일이 없다면, 직접 하나 기여해서 다음에 그 파일을 찾을 개발자를 도와줄 수 있어요. 자세한 내용은 DefinitelyTyped의 contribution guidelines page를 확인해 주세요.