TypeScript'ten JSDoc yorumlarına
TypeScript işlev ve arabirim tiplerini JSDoc yorumlarına dönüştür, böylece tipler düz JavaScript'te de korunur.
TypeScript'ten JSDoc yorumlarına
Bir TypeScript işlev, ok işlev, arayüz veya tip takma adı yapıştırın ve bu araç buna karşılık gelen JSDoc yorumunu yazar — her parametre için `@param`, dönüş tipi için `@returns` ve nesne şeklindeki arayüzler ve tip takma adları için `@property` satırları olan `@typedef`. Kodu `.ts`'den düz `.js`'ye taşımak, bir editör veya JSDoc'a duyarlı bir linterın yine de ihtiyaç duyduğu tip bilgisini kaybetmek amacıyla oluşturulmuştur.
"TypeScript tiplerini kaldır" seçeneği, tip söz dizimini imzanın kendisinden kaldırır — parametre tipleri, dönüş tipleri, genel parametre listeleri — geçerli JavaScript bırakarak, burada aynı bilgi şimdi yorum içinde yaşar; TypeScript'i olduğu gibi tutmak ve sadece belgelendirmeyi üstüne koymak istiyorsanız kapatın. "Arayüzler için @typedef oluştur" bir `interface` veya nesne `type`'ını bir typedef bloğuna dönüştürür; "Genel türler için @template ekle" `<T>` gibi tip parametrelerini belgeler; "Throw ifadelerinden @throws ekle" her işlev gövdesini `throw new SomeError(...)` arayışında tarar ve bulunan farklı hata tiplerini listeler. Yorum stili, geleneksel yıldız hizalı blok ile daha sıkı bir satır açık varyant arasında geçiş yapar ve satır genişliği uzun bir satırın nerede kırıldığını kontrol eder.
Araç üst düzey işlev bildirimleri, `const` veya `let`'e atanan ok işlevleri, arayüzleri ve nesne şeklindeki tip takma adlarını okur — JSDoc'un bir etiketi olan bildirimler. İşlev gövdesi içindeki yerel değişkenlerdeki tip ek açıklamaları ve bir sınıf içinde veya nesne değişmezinde tanımlanan yöntemler yazıldığı gibi bırakılır; bir dosyadaki her tipi güvenli bir şekilde yeniden yazmak tam bir derleyici gerektirir ve bu küçük ve hızlı bir komut dosyası olarak kalır ve yazmayı durdurduğunuz anda çalışır.
Her şey tarayıcınızda yerel olarak çalışır — kodunuz hiçbir zaman yüklenmez, bu nedenle özel bir projeden yapıştırma güvenlidir. Sonucu kopyalayın, .txt dosyası olarak indirin veya çıktıyı doğrudan girdiye gönderin ve sonraki aracı çalıştırın.