global.d.ts 이란?
- global: 전역 영역에 타입을 확장하기 위한 것
- .d.ts: **타입 정의 파일 (declaration file)**이라는 뜻
사용예시
상황 | 예시 |
window.kakao | TypeScript는 window.kakao가 뭔지 모르기 때문에 window에 kakao 속성을 직접 정의해야 함 |
전역 타입 선언 | 예: type UserRole = 'admin' | 'user' 처럼 어디서든 쓰고 싶은 타입 |
전역 변수 선언 | 예: declare const VERSION: string |
전역 모듈 확장 | 예: declare module '*.svg' { ... } |
예시코드
export {}; declare global { interface Window { kakao: any; } }
export {};- 이 파일이 모듈로 취급되도록 강제하는 선언입니다.
- 이걸 안 쓰면 전역 타입 정의가 충돌하거나 모듈 스코프로 인식되지 않아 문제가 생길 수 있어요.
declare global {
interface Window {
kakao: any;
}
}- window 객체를 전역적으로 확장하는 선언입니다.
- TypeScript는 기본적으로 window.kakao가 뭔지 모르기 때문에 직접 정의해줘야 함.