TypeScript · 25 선언 파일과 외부 경계
단계: 모듈 계약과 플러그인 · 편집 가능한 예제 · 저장 ID: typescript-step-25
목표와 학습 후 역량
- 잘못된 인수 호출의 진단을 남긴다.
- 선언과 실제 반환 타입을 비교한 로그가 있다.
선수 지식
24단위 「모듈과 type-only import」의 결과물과 실험 기록
핵심 개념과 설명
선언 계약
d.ts는 구현의 타입 계약을 기술합니다. 실제 JavaScript 동작을 만들어 주지는 않습니다.
계약 불일치
잘못된 선언도 소비자 검사를 통과시킬 수 있습니다. 구현과 선언을 같은 호출 사례로 확인합니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 로컬 프로젝트에서 직접 구현하고 브라우저 개발자 도구와 tsc --noEmit로 확인하세요. 별도 TypeScript 프로젝트에서 설치한 tsc 버전을 기록하세요. tsconfig.json에 strict를 켜고 tsc --noEmit으로 검사한 뒤, 실행 실습은 컴파일 출력 또는 로컬 개발 서버로 여세요. TS 타입 표기를 브라우저가 직접 실행한다고 가정하지 않습니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- legacy.d.ts 파일에 문자열 키와 숫자 키 호출 조건을 준비하세요.
- 작은 legacy.js 저장 함수를 선언하고 TS 소비자에서 정상·잘못된 인수로 호출하세요.
- 문자열 키와 숫자 키 호출 조건으로 실행하세요. 확인할 결과: 잘못된 인수 호출의 진단을 남긴다. 선언과 실제 반환 타입을 비교한 로그가 있다. 예상과 실제 결과는 구분해 기록하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 선언 반환 | 실제 문자열 | 잘못된 숫자 선언 | 실행 전 가설: 컴파일 성공과 런타임 동작이 어긋날 수 있다. 다른 조건은 고정하고 실행 후 실제 결과를 따로 기록합니다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 잘못된 인수 호출의 진단을 남긴다.
- 선언과 실제 반환 타입을 비교한 로그가 있다.
자가 점검
- d.ts만 배포하면 구현도 생기나요?
- 부정확한 선언의 책임을 어떻게 찾나요?
공식 참고
연결된 예제와 실행 범위
미리보기는 JavaScript 런타임 경계 실험입니다. TypeScript 진단은 실행하지 않습니다. lesson.ts를 로컬 tsc --strict --noEmit --lib ES2023,DOM 으로 검사하세요.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: 모듈과 type-only import · 다음: 컴파일 실패를 검증하는 사례