IronPDF for Node.js における verbatimModuleSyntax エラー

オプションの動作

falseに設定する（一般的な選択肢）： TypeScriptはインポートおよびエクスポートステートメントをターゲットのモジュールシステムに一致するように書き換えます。 CommonJS ターゲットでは、ESMスタイルのインポート (import ... from '...') into require()呼び出しのため; ESNext ターゲットでは ESM 構文をそのまま保持します。

trueに設定する： TypeScriptはインポートおよびエクスポートの構文をそのままの形で保持します。 ターゲットに関係なく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をサポートしていないために発生します； 2 番目の理由は、ESM 構文が CommonJS モジュールのために未変換のまま残される場合です。

推奨事項

ほとんどのプロジェクトでは、オプションを無効にして TypeScript がモジュール構文を調整させるようにしてください：

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

特定のバンドラーや環境に対して厳密な構文の保持が必要な場合は、モジュールシステムがソースが使用する構文を完全にサポートしている場合にのみtrueに設定してください。