# verbatimModuleSyntax Errors in IronPDF for Node.js
Wenn Sie IronPDF for Node.js in einem TypeScript-Projekt verwenden, steuert die `verbatimModuleSyntax` Compiler-Option, wie `import` und `export` Anweisungen ausgegeben werden, und es kann zu Build-Fehlern kommen, wenn es mit Ihrem Modul-System in Konflikt steht.
## 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:
```txt
A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled.
```
```txt
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:
```json
{
"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.
Wenn Sie IronPDF for Node.js in einem TypeScript-Projekt verwenden, steuert die verbatimModuleSyntax Compiler-Option, wie import und export Anweisungen ausgegeben werden, und es kann zu Build-Fehlern kommen, wenn es mit Ihrem Modul-System in Konflikt steht.
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.
A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled.
Text
ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.
ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.
Text
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:
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.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.
