CodeBlanks Logo Icon CodeBlanks

Paket tasarımı

Çok dosyalı kütüphane iskeletini kurarsın.

Paket tasarımı

Bir kütüphane paketi genellikle çok dosyalı bir iskelet üzerine kurulur. Her dosya tek bir sorumluluğa sahiptir: türler, yardımcı fonksiyonlar ve giriş noktası ayrı dosyalardadır. src/index.ts dosyası paketin dışarıya açılan kapısıdır ve diğer modülleri birleştirir.

src/
  types.ts      // tür tanımları
  helpers.ts    // yardımcı fonksiyonlar
  index.ts      // giriş noktası

Modül yapısı

Her dosya bir modüldür; export ile değer dışa aktarılır, import ile içe aktarılır. tsconfig.json ise derleme seçeneklerini ve hedef dizini belirler. Bu sayede paket derlendiğinde tek bir dist/ klasörü oluşur.

// types.ts
export interface Kitap { ad: string; }
// index.ts
export { Kitap } from "./types";

Uygulama Kitap arayüzü ve ekleme fonksiyonu

Kitap adında bir interface tanımla; içinde ad: string özelliği olsun. kitapEkle fonksiyonu title: string parametresi alıp Kitap türünde { ad: title } dönsün. kitapEkle("TypeScript").ad sonucunu console.log ile yazdır.

Başlangıç kodu

index.ts
// Kitap adında interface tanımla: ad: string
// kitapEkle fonksiyonu title alıp Kitap dönsün
// kitapEkle("TypeScript").ad sonucunu yazdır

Örnek çözüm

index.ts
interface Kitap {
  ad: string;
}
function kitapEkle(title: string): Kitap {
  return { ad: title };
}
console.log(kitapEkle("TypeScript").ad);

Beklenen çıktı

TypeScript

Soru ve cevaplar

Dersin sorularını cevaplarıyla birlikte inceleyebilirsin. Kendini denemek istersen dersi interaktif olarak çöz.

1 Bir kütüphane paketinde index.ts'nin görevi nedir?

  • Yalnızca tür tanımlarını içerir
  • Çalışma zamanı kodu içermez
  • tsconfig.json yerine geçer
  • Paketin giriş noktası olarak modülleri birleştirir Doğru cevap

Açıklama: index.ts paketin giriş noktasıdır; diğer modülleri içe aktarır ve yeniden dışa aktararak tek bir API sunar.

2 Dışa aktarma anahtar kelimesi

Soru
// types.ts
____ interface Kitap { ad: string; }
Cevap
// types.ts
export interface Kitap { ad: string; }

Açıklama: Bir modülden değer dışa aktarmak için export anahtar kelimesi kullanılır; import ile içe aktarılır.

3 Paket parçaları

Kavram Anlamı
src/types.ts Tür tanımları
src/helpers.ts Yardımcı fonksiyonlar
src/index.ts Giriş noktası
tsconfig.json Derleme ayarları

Orta seviye bölümündeki tüm dersler