types · typeRoots

전역 타입 선언 범위

TypeScript는 기본적으로 node_modules/@types를 자동 탐색하지만, 테스트 러너나 런타임 전역 타입이 겹치면 typestypeRoots로 범위를 명시합니다.

기본값

모든 @types 자동 포함

가까운 상위 디렉터리의 @types 패키지를 전역 선언 후보로 읽습니다.

types

패키지 이름 화이트리스트

"types": ["node", "jest"]

나열한 전역 타입만 포함하여 DOM, Node, Jest 같은 전역 충돌을 제어합니다.

typeRoots

탐색 루트 디렉터리 지정

"typeRoots": ["./types", "./node_modules/@types"]

사내 선언 파일이나 커스텀 앰비언트 모듈 위치를 명시적으로 추가합니다.

전역 선언 포함

types

프로젝트 전체에 자동 주입되는 전역 이름의 목록을 좁힙니다.

typeRoots

전역 타입 패키지를 어느 디렉터리에서 찾을지 바꿉니다.

모듈 import 해석

import

코드에서 직접 가져온 모듈 타입은 별도의 모듈 해석 규칙을 따릅니다.

전역 타입 선언 한계

전역 타입 제한과 런타임 패키지 설치 여부는 서로 다른 문제입니다.