12 타입스크립트 프로젝트 관리

12.3 타입스크립트 마이그레이션

1. 타입스크립트 마이그레이션의 필요성

상황에 따라 비즈니스 요구 사항의 변화를 반영할 수 있는 새로운 설계를 기반으로 타입을 작성하는 게 효율적일 수 있다.

프로젝트의 규모와 특성 및 내외부 여건을 종합적으로 고려하여, 기존 프로젝트를 신규 프로젝트로 바꾸는 게 나을지 단순히 마이그레이션하는 게 나을지를 신중하게 따져봐야 한다.

2. 점진적인 마이그레이션

작은 부분부터 마이그레이션을 시작할 수 있기 때문에 진입 장벽이 낮아지고 프로젝트의 전반적인 동작을 안정적으로 유지할 수 있게 된다.

하지만 단순히 allowJS를 true, noImplicitAny를 false로 설정한 채 무기한으로 마이그레이션을 미루는 것은 지양해야 한다.

데드라인이 없는 프로젝트는 언제 완료될지 모르는 과도기에 빠질 수 있다.

따라서 점진적인 타입스크립트 마이그레이션을 진행하기로 했다면, 프로젝트 참여자와 함께 우선순위를 대략적이라도 설정해두는 게 좋다.

3. 마이그레이션 진행하기

타입스크립트 마이그레이션을 진행하기로 했다면 다음과 같은 단계를 거치게 된다.

1. 타입스크립트 개발 환경을 설정하고, 빌드 파이프라인에 타입스크립트 컴파일러를 통합한다.

tsconfig.json 파일에서 allowJS를 true로 noImplicitAny를 false로 설정해야 한다.

allowJS(기본값: false)는 자바스크립트 파일을 컴파일할 때 사용하는 옵션으로, 기존 자바스크립트 함수를 타입스크립트에서 임포트하거나 반대로 타입스크립트 함수를 자바스크립트에서 임포트할 수 있게 해준다.

또한 noImplicitAny는 암시적 any 타입이 있을 때 오류가 발생하게 하는 옵션이다.

따라서 타입을 점진적으로 추가하는 과정에서는 오류가 발생하지 않도록 noImplicitAny를 false로 설정해야 한다.

2. 작성된 자바스크립트 파일을 타입스크립트 파일로 변환한다.

이 단계에서는 필요한 타입과 인터페이스를 하나씩 정의하며 함수 시그니처를 추가해나간다.

3. 기존 자바스크립트 파일을 모두 타입스크립트로 변환하는 작업이 완료되었다면 tsconfig.json 파일을 수정한다.

allowJS를 false로 변경하고, noImplicitAny를 true로 설정하여 타입이 명시되지 않은 부분이 없는지 점검한다.