IronPDF for Node.js에서의 verbatimModuleSyntax 오류

옵션의 동작 방식

false로 설정 (일반 선택): TypeScript는 대상 모듈 시스템에 맞게 import 및 export 문을 재작성합니다. CommonJS 대상을 사용할 때 ESM 스타일의 가져오기를 (import ... from '...') into require() 호출; ESNext 대상을 사용할 때 ESM 구문을 유지합니다.

true로 설정: TypeScript는 작성된 그대로 import 및 export 구문을 유지합니다. ESM 구문은 대상에 관계없이 ESM으로 남게 되며, 모듈 시스템이 이를 지원하지 않을 때 실패합니다.

활성화 시의 오류

"verbatimModuleSyntax": true로 CommonJS 빌드는 다음과 같은 오류로 실패할 수 있습니다:

A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled.

ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.

첫 번째는 CommonJS가 최상위 export를 지원하지 않기 때문에 발생합니다; 두 번째는 CommonJS 모듈에 대해 ESM 구문이 변환되지 않고 남은 경우입니다.

추천

대부분의 프로젝트에서는 옵션을 비활성화하여 TypeScript가 모듈 구문을 조정하도록 유지하세요:

{
  "compilerOptions": {
    "verbatimModuleSyntax": false
  }
}

특정 번들러나 환경에 대한 엄격한 구문 보존이 필요하다면, 사용 중인 모듈 시스템이 소스에서 사용하는 구문을 완전히 지원하는 경우에만 true로 설정하십시오.