Dosya Dosya Dönüştürme Stratejisi
Hiçbir şeyi bozmadan .js dosyalarını artımlı olarak .ts olarak yeniden adlandırın
Dosya Dosya Dönüştürme Stratejisi, CoddyKit'te ücretsiz bir TypeScript Academy dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, TypeScript Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. TypeScript Academy kursu toplamda 4 dersten oluşur.
Kademeli Yaklaşım
Dosya dosya dönüşümde her seferinde bir .js dosyasının adı .ts olarak değiştirilir ve ilerledikçe tür hataları düzeltilir. Bu, projenin her adımda derlenmeye devam etmesini sağlar.
# Step 1: rename
mv src/utils.js src/utils.ts
# Step 2: fix errors
npx tsc --noEmit
# Step 3: commit and repeatNereden Başlanacağını Seçme
Yaprak modüllerle başlayın — bunlar diğer proje dosyalarından içe aktarma yapmayan dosyalardır. Bu dosyaların öncelikle karşılanması gereken aşağı akış TypeScript bağımlılıkları yoktur.
# Find files with fewest imports from other project files:
grep -r "from './" src --include="*.js" | sort | uniq -c | sort -n
# Convert lowest-count files firstÖrtük any Hatalarını Ele Alma
Bir JS dosyasının adı .ts olarak değiştirildiğinde, noImplicitAny: true ise tür içermeyen parametreler örtük any hatalarına dönüşür. Açık türler ekleyin veya geçici olarak any kullanın.
// Before: JS
function process(data) { return data.value; }
// After: TS (add annotation)
function process(data: { value: string }) { return data.value; }
// Or temporarily:
function process(data: any) { return data.value; }Hataları Geçici Olarak Bastırma
Düzeltilmesi zor satırlarda // @ts-ignore kullanın ve unutulmamaları için bunları TODO olarak takip edin.
// TODO: type this properly in follow-up PR
// @ts-ignore
const result = complexLegacyFunction(x);İçe Aktarma İfadelerini Güncelleme
Bir dosya .ts olduğunda, bu dosyayı kullanan kodların içe aktarmaları güncellemesi gerekebilir. TypeScript, içe aktarma yollarında dosya uzantısı olmadan .ts dosyalarını otomatik olarak çözümler.
// No extension needed — TypeScript finds .ts
import { process } from "./utils";Üçüncü Taraf require Kullanımlarını Dönüştürme
TypeScript modül çözümlemesiyle uyum sağlamak için dönüşüm sırasında CommonJS require çağrılarını ES modülü import söz dizimiyle değiştirin.
// Before: CommonJS
const fs = require("fs");
// After: ES module
import fs from "fs";Katı Moda Kademeli Geçiş
Dosya başına // @ts-strict-ignore yorumlarını kullanarak veya katı modun etkin olduğu ayrı bir tsconfig'e geçerek katı bayrakları dosya bazında kademeli olarak etkinleştirin.
// tsconfig.strict.json — points to converted files only
{
"extends": "./tsconfig.json",
"compilerOptions": { "strict": true },
"include": ["src/converted/**/*"]
}Kalan Dosyaları Takip Etme
Kalan .js dosyalarını saymak ve geçişin zaman içindeki ilerlemesini takip etmek için bir kontrol listesi tutun veya bir betik kullanın.
find src -name "*.js" | wc -l # remaining JS files
find src -name "*.ts" | wc -l # converted TS filesBüyük PR'lerden Kaçınma
İncelemeleri yönetilebilir tutmak için her PR'de bir dosya dönüştürün. Kapsamı tek tek dosyalarla sınırlanan büyük TypeScript geçişlerini incelemek ve geri almak daha kolaydır.
# Good: one file per PR
# Bad: 50 files renamed in one PRHer Dönüşümden Sonra Sınamaları Çalıştırma
TypeScript'in tür denetleyicisinin yakalayamayabileceği çalışma zamanı gerilemelerini tespit etmek için her dosya dönüşümünden sonra sınama paketini çalıştırın.
npm test
# Ensure all tests pass after each .js → .ts renameÖzet: Dosya Dosya Stratejisi
Önce yaprak dosyaları dönüştürün, hataları düzeltin veya bastırın, projenin her adımda derlenmeye devam etmesini sağlayın, kalan JS dosyalarını takip edin ve incelemeleri yönetilebilir tutmak için her PR'de bir dosya gönderin.
Hızlı Kontrol
Dosya dosya geçişte önce hangi dosyaları TypeScript'e dönüştürmelisiniz?
Öğrendikleriniz
Dosya dosya geçiş: yaprak modüllerle başlayın, dosyanın adını .ts olarak değiştirin, hataları düzeltin veya bastırın, projenin derlenmeye devam etmesini sağlayın ve ilerlemeyi takip edin. PR başına yapılan küçük dönüşümler, geçişi güvenli ve incelenebilir hâle getirir.
Sıkça Sorulan Sorular
“Dosya Dosya Dönüştürme Stratejisi” dersi ücretsiz mi?
Evet — “Dosya Dosya Dönüştürme Stratejisi” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve TypeScript Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. TypeScript Academy kursu toplamda 4 dersten oluşur.
“Dosya Dosya Dönüştürme Stratejisi” dersinde ne öğreneceğim?
Hiçbir şeyi bozmadan .js dosyalarını artımlı olarak .ts olarak yeniden adlandırın TypeScript Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
TypeScript Academy öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te TypeScript Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.
“Dosya Dosya Dönüştürme Stratejisi” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu TypeScript Academy dersinde kod yazıp çalıştırabilir miyim?
Evet. Her TypeScript Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- Geçişi Başlatma: allowJs ve checkJs
- Köprü Olarak JSDoc Tür Açıklamaları
- Dosya Dosya Dönüştürme Stratejisi
- Türlendirilmemiş Üçüncü Taraf Kitaplıklarını Yönetme