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.