TypeScript Config (tsconfig.json) Detaylı Rehber

TypeScript, JavaScript’in güçlü bir üst kümesi olarak, yazılım geliştirme süreçleri için daha iyi bir yapı ve güvenilirlik sağlar. TypeScript projelerinin kalbinde, konfigürasyon dosyası olan tsconfig.json bulunur. Bu dosya, TypeScript derleyicisinin (compiler) nasıl çalışacağını ve projedeki dosyaların nasıl derleneceğini tanımlar. Bu makalede, tsconfig.json dosyasının detaylarını ve çeşitli seçeneklerini inceleyeceğiz.

1. tsconfig.json Nedir?

tsconfig.json, TypeScript projelerinde kullanılan bir konfigürasyon dosyasıdır. Bu dosya, projedeki kaynak dosyalarının konumlarını belirtmek, derleyici ayarlarını yapılandırmak ve TypeScript derleyicisinin çalışmasını kontrol etmek için kullanılır. İçeriği JSON formatında olup, derleyiciye hangi dosyaların dahil edileceği ve hangi ayarların kullanılacağını tanımlar.

1.1. Temel Yapı

Bir tsconfig.json dosyası aşağıdaki gibi basit bir yapı ile oluşturulabilir:

{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

Bu örnekte, compilerOptions bölümü, derleyici tarafından kullanılacak bazı temel ayarları içerir. include ve exclude bölümleri ise, hangi dosyaların derleneceğini ve hangilerinin derleme sürecine dahil edilmeyeceğini belirler.

2. tsconfig.json Ayarları

Birçok önemli ayar tsconfig.json dosyasında tanımlanabilir. İşte yaygın olarak kullanılan bazı ayarlar:

2.1. compilerOptions

compilerOptions alanı, TypeScript derleyicisinin nasıl çalışacağını tanımlamak için kullanılır. Aşağıda bazı önemli seçenekler yer almaktadır:

• target: Hedef JavaScript versiyonu (örneğin, es5, es6)
• module: Modül sistemi (örneğin, commonjs, es2015)
• strict: Katı tip kontrolünü etkinleştirir (true/false)
• outDir: Derleme sonuçlarının kaydedileceği dizin
• sourceMap: Kaynak haritaları oluşturulup oluşturulmayacağı

2.2. include ve exclude

include alanı, derlemeye dahil edilecek dosya veya dizinlerin bir listesini içerirken, exclude alanı, derlemeden hariç tutulacak dosya veya dizinleri belirtir. Örnek:

"include": ["src/**/*"],
"exclude": ["node_modules"]

3. Sonuç

TypeScript’in sağladığı statik tip kontrolü ve güçlü özelliklerden tam anlamıyla yararlanmak için tsconfig.json dosyasının doğru yapılandırılması son derece önemlidir. Bu makalede, tsconfig.json dosyasının temel yapılandırması ve önemli ayarları hakkında bilgi verdik. Doğru bir yapılandırma ile TypeScript projelerinizin daha sağlam ve sürdürülebilir olmasını sağlayabilirsiniz. Projelerinizde bu rehberi kullanarak tsconfig.json dosyanızı yapılandırmayı ihmal etmeyin!