Bir JavaScript Projesi TypeScript'e Nasıl Dönüştürülür

Bir JavaScript projesini TypeScript'e dönüştürmek, statik tür denetimi ekleyerek kod kalitesini ve sürdürülebilirliğini iyileştirebilir. Bu kılavuz, mevcut bir JavaScript projesini TypeScript'e dönüştürmek için adım adım bir süreç sağlar.

Adım 1: TypeScript'i yükleyin

Projeye TypeScript ekleyerek başlayın. Bu npm veya yarn kullanılarak yapılır.

npm install typescript --save-dev

Adım 2: TypeScript Yapılandırma Dosyası Oluşturun

TypeScript'i yapılandırmak için tsconfig.json dosyası oluşturun. Bu dosya derleyici seçeneklerini ve derlemeye dahil edilecek dosyaları belirtir.

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

Adım 3: JavaScript Dosyalarını TypeScript Olarak Yeniden Adlandırın

JavaScript dosyalarının adını .js'dan .ts'ya (veya React kullanıyorsanız .jsx'dan .tsx'ya) değiştirin. Bu, TypeScript'in bu dosyaları işlemesine olanak tanır.

  • JSX içeren dosyaların adını .tsx olarak değiştirin.
  • Sadece TypeScript koduna sahip dosyaların adını .ts olarak değiştirin.

Adım 4: Tür Tanımlarını Ekleyin

Projede kullanılan üçüncü taraf kütüphaneler için tip tanımları ekleyin. Bunlar npm'de @types paketleri olarak mevcuttur.

npm install @types/node @types/express --save-dev

Adım 5: TypeScript Hatalarını Düzeltin

Projeyi TypeScript kullanarak derleyin ve hataları veya tür sorunlarını giderin. TypeScript, tür uyumsuzlukları ve diğer sorunlar hakkında geri bildirim sağlayacaktır.

npx tsc

Adım 6: Derleme Komut Dosyalarını Güncelleyin

package.json dosyasındaki yapı betiklerini TypeScript kullanacak şekilde güncelleyin. Betikleri TypeScript derlemesini içerecek şekilde değiştirin.

"scripts": {
  "build": "tsc",
  "start": "node dist/index.js"
}

Adım 7: Uygulamayı test edin

Dönüştürülen TypeScript kodunun beklendiği gibi çalıştığından emin olmak için testler çalıştırın. Uygulamanın dönüşümden sonra doğru şekilde davrandığını doğrulayın.

Çözüm

Bir JavaScript projesini TypeScript'e dönüştürmek, TypeScript'i yüklemeyi, derleyiciyi yapılandırmayı, dosyaları yeniden adlandırmayı, tür tanımları eklemeyi ve hataları çözmeyi içerir. Bu süreç, daha iyi tür güvenliği ve kod sürdürülebilirliği için TypeScript'in özelliklerinden yararlanmaya yardımcı olur.