Kodkitabi

Modüller ve Bildirim Dosyaları

TypeScript içinde modüller ve bildirim dosyaları kavramını, kullanım sınırlarını ve güvenilir uygulama biçimini öğrenin.

Modüller ve Bildirim Dosyaları, TypeScript ile uygulama sınırları çalışırken hata durumlarını denetlenebilir bir akışa dönüştürmek için kullanılan yaklaşımı açıklar. Modüller görünürlük sınırı kurar ve birlikte değişen davranışları aynı yerde toplar.

Döngüsel bağımlılıklardan kaçınmak, dışarı yalnızca kararlı bir yüzey açmak ve sürüm sözleşmesini kaydetmek bakım maliyetini düşürür. Girdinin biçimini ve geçerliliğini sınırda denetlemek, iç katmanların daha sade kalmasını sağlar. Aşağıdaki örnek, konuyu küçük ve izlenebilir bir akış içinde gösterir.

Yaygın hata ve doğru yaklaşım

Kavramı her durumda uygulanacak bir kural gibi kullanmak gereksiz karmaşıklık üretir. Önce problemin sınırını belirleyin, ardından en küçük yeterli yapıyı seçin.

Sonuç

Modüller ve Bildirim Dosyaları, doğru sınırlar ve açık bir sözleşmeyle kullanıldığında TypeScript kodunun güvenilirliğini artırır. Önce doğruluğu kurun; ölçüm göstermeden karmaşık optimizasyona yönelmeyin.

Modüller ve Bildirim Dosyaları örneği
type Result<T> = { ok: true; value: T } | { ok: false; error: string };

async function loadTitle(): Promise<Result<string>> {
  try {
    return { ok: true, value: "Modüller ve Bildirim Dosyaları" };
  } catch (error: unknown) {
    return { ok: false, error: error instanceof Error ? error.message : "Bilinmeyen hata" };
  }
}