Erros de verbatimModuleSyntax no IronPDF for Node.js
Quando você usa o IronPDF for Node.js em um projeto TypeScript, a opção de compilador verbatimModuleSyntax controla como os comandos import e export são emitidos, e pode causar erros de compilação quando conflita com seu sistema de módulo.
Como a opção se comporta
Defina para false (a escolha comum): O TypeScript reescreve as instruções de import e export para corresponder ao sistema de módulo de destino. Com um objetivo CommonJS, ele converte importações no estilo ESM (import ... de '...') into `chamadas require(); com um objetivo ESNext, ele mantém a sintaxe ESM.
Defina para true: O TypeScript preserva a sintaxe de import e export exatamente como escrita. A sintaxe ESM permanece ESM, independentemente do destino, o que falha quando o sistema de módulos não a suporta.
Erros quando habilitado
Com "verbatimModuleSyntax": true, uma construção CommonJS pode falhar com:
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.O primeiro acontece porque o CommonJS não suporta um export de nível superior; o segundo ocorre quando a sintaxe ESM é deixada não transformada para um módulo CommonJS.
Recomendação
Para a maioria dos projetos, mantenha a opção desativada para que o TypeScript ajuste a sintaxe do módulo para você:
{
"compilerOptions": {
"verbatimModuleSyntax": false
}
}Se você precisar de uma preservação estrita da sintaxe para um empacotador específico ou ambiente, defina-o para true apenas quando seu sistema de módulo suportar totalmente a sintaxe que sua fonte usa.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
