IronPDF for Node.js'de verbatimModuleSyntax Hataları

Curtis Chau
Curtis Chau
Updated: 29 Haziran 2026

Bir TypeScript projesinde IronPDF for Node.js kullanıyorsanız, verbatimModuleSyntax derleyici seçeneği, import ve export ifadelerinin nasıl yayımlandığını kontrol eder ve modül sisteminizle çakıştığında derleme hatalarına neden olabilir.

Seçeneğin nasıl davrandığı

false olarak ayarlayın (yaygın tercih): TypeScript, import ve export ifadelerini hedef modül sistemine uyacak şekilde yeniden yazar. Bir CommonJS hedefi ile, ESM biçemindeki ithalatları (import ... '...') into require() çağrılarından; bir ESNext hedefi ile ESM biçemini korur.

true olarak ayarlayın: TypeScript, import ve export sözdizimini tam olarak yazıldığı gibi korur. ESM biçemi hedef bağımsız olarak ESM kalır, bu da modül sistemi bunu desteklemediğinde başarısız olur.

Etkinleştirildiğinde hatalar

"verbatimModuleSyntax": true ile, bir CommonJS derleme şu şekilde başarısız olabilir:

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.
Text

İlki, CommonJS'in üst düzey export'yi desteklememesi nedeniyle meydana gelir; ikincisi, bir CommonJS modülü için ESM biçeminin dönüştürülmeden bırakıldığı sırada olur.

Tavsiye

Çoğu proje için, seçeneği devre dışı bırakıp TypeScript'in sizin için modül sözdizimini ayarlamasını sağlayın:

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

Belirli bir paketleyici veya ortam için sıkı bir sözdizimi korumasına ihtiyacınız varsa, modül sisteminiz kaynağınızın kullandığı sözdizimini tam olarak destekliyorsa true'ye ayarlayın.

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

Sürüm:2026.11yeni yayınlandı