CommonJS interop

상호 운용 오류를 줄이는 네 가지 설정

CommonJS 패키지를 가져올 때는 소스 문법만 보지 말고 출력 형식, Node 해석 규칙, 기본 가져오기 헬퍼, 타입 정의 위치를 함께 맞춥니다.

module

출력 형식

CommonJS, Node16, ESNext 중 런타임이 읽을 형식과 맞춥니다.

package

Node 기준

type 필드와 파일 확장자가 실제 실행 모듈 체계를 결정합니다.

interop

기본 가져오기

esModuleInterop은 module.exports 값을 default처럼 다룰 때의 차이를 줄입니다.

types

타입 표면

@types 또는 직접 작성한 선언이 실제 내보내기 모양과 같은지 확인합니다.

undefined

default import가 비어 있음

패키지가 module.exports = fn인지, 선언 파일이 default export를 약속하는지 비교합니다.

syntax

실행 단계 문법 오류

컴파일된 JS의 import/export가 현재 Node 설정에서 허용되는지 확인합니다.

any

타입 정보가 사라짐

라이브러리의 types 필드, @types 패키지, 로컬 .d.ts 포함 범위를 봅니다.