verbatimModuleSyntax Errors in IronPDF for Node.js

Wie die Option funktioniert

Setzen Sie es auf false (die übliche Wahl): TypeScript überschreibt Import- und Exportanweisungen, um dem Zielmodul-System zu entsprechen. Mit einem CommonJS-Ziel konvertiert es ESM-Style-Imports (import ... from '...') into require() Aufrufe; bei einem ESNext-Ziel bleibt die ESM-Syntax erhalten.

Setzen Sie es auf true: TypeScript bewahrt die Import- und Exportsyntax genau so, wie sie geschrieben wurde. ESM-Syntax bleibt ESM unabhängig vom Ziel, was fehlschlägt, wenn das Modulsystem es nicht unterstützt.

Fehler wenn aktiv

Mit "verbatimModuleSyntax": true kann ein CommonJS-Build fehlschlagen mit:

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.

Das erste tritt auf, weil CommonJS keinen top-level export unterstützt; der zweite tritt auf, wenn ESM-Syntax für ein CommonJS-Modul untransformiert bleibt.

Empfehlung

Für die meisten Projekte halten Sie die Option deaktiviert, sodass TypeScript die Modulsyntax für Sie anpasst:

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

Wenn Sie eine strikte Syntaxbewahrung für einen bestimmten Bundler oder eine Umgebung benötigen, setzen Sie es nur dann auf true, wenn Ihr Modul-System die Syntax, die Ihr Quelltext verwendet, vollständig unterstützt.