아이템 59 타입스크립트 도입 전에 @ts-check와 JSDoc으로 시험해 보기

@ts-check 지시자를 사용하면 타입 불일치나 함수의 매개변수 개수 불일치 같은 간단한 오류 외에도, 다음에 소개하는 몇 가지 의미 있는 오류를 찾아낼 수 있다.

• 선언되지 않은 전역 변수
• 알 수 없는 라이브러리
• DOM 문제
• 부정확한 JSDoc

요약

• 파일 상단에 // @ts-check 를 추가하면 자바스크립트에서도 타입 체크를 수행할 수 있다.
• 전역 선언과 서드파티 라이브러리의 타입 선언을 추가하는 방법을 익히자.
• JSDoc 주석을 잘 활용하면 자바스크립트 상태에서도 타입 단언과 타입 추론을 할 수 있다.
• JSDoc 주석은 중간 단계이기 때문에 너무 공들일 필요는 없다. 최종 목표는 .ts 로 된 타입스크립트 코드임을 명심하자.