TypeScript · 24 모듈과 type-only import
단계: 모듈 계약과 플러그인 · 편집 가능한 예제 · 저장 ID: typescript-step-24
목표와 학습 후 역량
- 타입 전용 import의 출력 코드 차이를 남긴다.
- 실제 환경에서 모듈을 로드하고 오류가 없는지 확인한다.
선수 지식
23단위 「비동기 함수와 오류 타입」의 결과물과 실험 기록
핵심 개념과 설명
타입 가져오기
import type은 타입 용도라는 뜻을 명시합니다. 런타임 의존성과 구분할 수 있습니다.
실행 환경
module과 moduleResolution은 실행·번들 환경에 맞춰야 합니다. 옵션만 바꿔 경로 문제가 자동 해결되지는 않습니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 로컬 프로젝트에서 직접 구현하고 브라우저 개발자 도구와 tsc --noEmit로 확인하세요. 별도 TypeScript 프로젝트에서 설치한 tsc 버전을 기록하세요. tsconfig.json에 strict를 켜고 tsc --noEmit으로 검사한 뒤, 실행 실습은 컴파일 출력 또는 로컬 개발 서버로 여세요. TS 타입 표기를 브라우저가 직접 실행한다고 가정하지 않습니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- contracts.ts 파일에 브라우저 번들 환경의 두 모듈 조건을 준비하세요.
- 타입을 export하고 main.ts에서 import type으로 읽은 뒤 실제 함수 import와 출력 차이를 보세요.
- 브라우저 번들 환경의 두 모듈 조건으로 실행하세요. 확인할 결과: 타입 전용 import의 출력 코드 차이를 남긴다. 실제 환경에서 모듈을 로드하고 오류가 없는지 확인한다. 예상과 실제 결과는 구분해 기록하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| import 종류 | 일반 값 import | import type | 실행 전 가설: 타입 전용 의존성이 실행 코드에서 제거될 것이다. 다른 조건은 고정하고 실행 후 실제 결과를 따로 기록합니다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 타입 전용 import의 출력 코드 차이를 남긴다.
- 실제 환경에서 모듈을 로드하고 오류가 없는지 확인한다.
자가 점검
- type-only import를 값으로 쓸 수 있나요?
- 컴파일 성공인데 모듈 로딩이 실패하는 이유는 무엇인가요?
공식 참고
연결된 예제와 실행 범위
미리보기는 JavaScript 런타임 경계 실험입니다. TypeScript 진단은 실행하지 않습니다. lesson.ts를 로컬 tsc --strict --noEmit --lib ES2023,DOM 으로 검사하세요.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: 비동기 함수와 오류 타입 · 다음: 선언 파일과 외부 경계