TypeScript Betiklerini ts-node ile Çalıştırma Kılavuzu

TypeScript Betiklerini ts-node ile Çalıştırma Kılavuzu

TypeScript, modern web geliştirmenin vazgeçilmez bir parçası haline gelmiş, JavaScript’in süper kümesi olarak bilinen güçlü bir programlama dilidir. Tip güvenliği, daha iyi kod okunabilirliği ve büyük ölçekli uygulamalar için sunduğu avantajlarla geliştiricilerin tercih sebebi olmuştur. Ancak TypeScript’in bu faydalarından yararlanırken karşılaşılan temel bir zorluk vardır: Tarayıcılar ve Node.js gibi çalışma zamanı ortamları doğrudan TypeScript kodunu anlayamaz. Bu durum, TypeScript kodunun çalıştırılmadan önce standart JavaScript’e derlenmesini (transpile) gerektirir. Geleneksel olarak bu işlem, tsc (TypeScript Compiler) komutuyla yapılır ve ardından ortaya çıkan JavaScript dosyaları Node.js ile çalıştırılır. Bu, geliştirme sürecinde sürekli bir “derle ve çalıştır” döngüsü oluşturarak geliştirici deneyimini yavaşlatabilir. İşte tam da bu noktada ts-node devreye girerek bu süreci kökten basitleştirir ve geliştirme hızını önemli ölçüde artırır.

Bu makalede, ts-node‘un ne olduğunu, nasıl kurulduğunu, temel ve gelişmiş kullanım senaryolarını, hata ayıklama entegrasyonlarını, sınırlamalarını ve alternatiflerini detaylı bir şekilde inceleyeceğiz. Amacımız, ts-node‘u kullanarak TypeScript betiklerini sorunsuz bir şekilde çalıştırmak için kapsamlı bir rehber sunmaktır.

TypeScript ve JavaScript Arasındaki Köprü

TypeScript’in temel amacı, geliştirme sürecinde hataları erken yakalamak ve kodun daha sürdürülebilir olmasını sağlamaktır. Bunu, değişkenlere, fonksiyon parametrelerine ve dönüş değerlerine tipler atayarak yapar. Ancak bir TypeScript dosyasını (.ts veya .tsx) doğrudan Node.js ile çalıştırmaya çalıştığınızda, Node.js bu sözdizimini tanımaz ve bir hata fırlatır. Bu nedenle, TypeScript kodu önce JavaScript’e dönüştürülmelidir. Bu dönüştürme işlemine “derleme” veya “transpiling” denir ve TypeScript derleyicisi (tsc) tarafından gerçekleştirilir.

Geleneksel geliştirme akışı genellikle şöyledir:
1. TypeScript kodunu yazın (src/index.ts).
2. tsc komutunu çalıştırarak kodu JavaScript’e derleyin (dist/index.js).
3. Derlenmiş JavaScript dosyasını Node.js ile çalıştırın (node dist/index.js).

Bu adımlar, özellikle küçük değişiklikler yapıldığında veya bir betiği hızlıca test etmek istendiğinde zaman alıcı ve tekrarlayıcı olabilir. Her değişiklikte manuel olarak derleme yapmak veya bir dosya izleyici (file watcher) kullanmak bile ek bir karmaşıklık getirir. ts-node, bu ara adımı ortadan kaldırarak TypeScript kodunu doğrudan çalıştırmanıza olanak tanır, tıpkı Node.js’in JavaScript kodunu çalıştırması gibi. Bu, geliştirme döngüsünü hızlandırır ve geliştirici verimliliğini artırır.

ts-node Nedir?

ts-node, Node.js için TypeScript çalıştırma ortamıdır. TypeScript kodunu Node.js üzerinde doğrudan, derleme adımına gerek kalmadan çalıştırmayı sağlar. Temel olarak, ts-node Node.js’in require mekanizmasını (veya ES modülleri için import kancalarını) kullanarak, bir .ts dosyası yüklendiğinde onu anında JavaScript’e derler ve ardından Node.js’in bu JavaScript kodunu çalıştırmasını sağlar. Bu “anında derleme” (on-the-fly compilation) yaklaşımı, geliştirme sürecini önemli ölçüde hızlandırır.

ts-node‘un sunduğu temel avantajlar şunlardır:
* Hızlı Geliştirme Döngüsü: Kodu her değiştirdiğinizde manuel derleme yapmanıza gerek kalmaz. Sadece betiği çalıştırın ve ts-node gerisini halleder.
* Basitleştirilmiş Betik Çalıştırma: Tek bir komutla TypeScript betiklerini çalıştırabilirsiniz. package.json içindeki script’leri veya CLI araçlarını TypeScript ile yazmak çok daha kolay hale gelir.
* Kolay Hata Ayıklama: Hata ayıklama deneyimi, doğrudan JavaScript kodunu hata ayıklıyormuş gibi hissettirir, çünkü ts-node kaynak haritaları (source maps) sayesinde orijinal TypeScript kodunuzda hata ayıklama yapmanıza olanak tanır.
* REPL Desteği: ts-node‘u parametresiz çalıştırarak interaktif bir TypeScript REPL (Read-Eval-Print Loop) ortamına erişebilirsiniz. Bu, hızlı prototipleme ve TypeScript kodunu deneme için idealdir.
* TypeScript Yapılandırması ile Uyum: Projenizin tsconfig.json dosyasını otomatik olarak algılar ve içindeki derleyici seçeneklerini (target, module, baseUrl, paths vb.) kullanarak kodu derler.

Kurulum

ts-node‘u kullanmaya başlamadan önce, sisteminizde bazı ön koşulların kurulu olması gerekmektedir.

Ön Koşullar

1. Node.js ve npm/yarn: ts-node bir Node.js paketi olduğu için, sisteminizde Node.js ve paket yöneticisi (npm veya yarn) kurulu olmalıdır. Node.js’in resmi web sitesinden indirebilir veya nvm (Node Version Manager) gibi bir araçla kurabilirsiniz.
2. TypeScript: ts-node‘un düzgün çalışabilmesi için TypeScript derleyicisinin de kurulu olması gerekir. Genellikle ts-node ile birlikte kurulur, ancak bazen ayrı olarak da kurulması gerekebilir.

ts-node Kurulumu

ts-node‘u projenize iki farklı şekilde kurabilirsiniz: yerel (local) veya global. Çoğu proje için yerel kurulum tercih edilen yöntemdir.

Yerel Kurulum (Önerilen):
Bir proje içinde ts-node‘u yerel olarak kurmak, projenin bağımlılıklarını izole eder ve farklı projelerde farklı ts-node veya TypeScript versiyonları kullanmanıza olanak tanır. Bu, özellikle ekip ortamlarında veya sürekli entegrasyon (CI) sistemlerinde tutarlılık sağlar.

npm install -D ts-node typescript
veya yarn kullanıyorsanız
yarn add -D ts-node typescript

Buradaki -D veya --save-dev bayrağı, ts-node ve typescript‘i sadece geliştirme bağımlılığı (dev dependency) olarak kaydeder. Bunun nedeni, ts-node‘un genellikle üretim ortamında kullanılmaması ve sadece geliştirme sırasında kodunuzu çalıştırmak için gerekli olmasıdır.

Yerel olarak kurduktan sonra, ts-node komutunu doğrudan çalıştıramazsınız. Bunun yerine, npx komutunu kullanmanız veya package.json script’leri aracılığıyla çağırmanız gerekir. npx, node_modules/.bin içindeki yürütülebilir dosyaları bulup çalıştırmanıza olanak tanıyan bir npm aracıdır.

Global Kurulum (Daha az önerilen):
ts-node‘u global olarak kurmak, onu sisteminizdeki herhangi bir yerden doğrudan ts-node komutunu kullanarak çalıştırmanıza izin verir. Bu, özellikle hızlı prototipleme, tek seferlik betikler veya interaktif REPL kullanımı için uygun olabilir. Ancak, farklı projelerde farklı TypeScript versiyonları kullanma esnekliğini kısıtlar ve bağımlılık çakışmalarına yol açabilir.

npm install -g ts-node typescript
veya yarn kullanıyorsanız
yarn global add ts-node typescript

Global kurulum yaptıktan sonra, ts-node komutunu doğrudan terminalinizden çağırabilirsiniz:

ts-node your-script.ts

Genel kural olarak, projenizin kök dizininde yerel kurulum yapmayı tercih edin.

Temel Kullanım

ts-node‘un kurulumu tamamlandıktan sonra, TypeScript betiklerini çalıştırmak oldukça basittir.

Basit Bir TypeScript Betiği Oluşturma

Öncelikle, çalıştıracağımız basit bir TypeScript dosyası oluşturalım. Projenizin kök dizininde src adında bir klasör oluşturun ve içine index.ts adında bir dosya ekleyin:

// src/index.ts
function greet(name: string): string {
    return Merhaba, ${name}! ts-node ile çalışıyorum.;
}

const userName: string = "Dünya";
console.log(greet(userName));

// Bir asenkron işlem de ekleyelim
async function fetchData(): Promise {
    return new Promise((resolve) => {
        setTimeout(() => {
            resolve("Veri başarıyla çekildi!");
        }, 1000);
    });
}

fetchData().then(data => console.log(data));

Betiği Çalıştırma

Şimdi bu betiği ts-node ile çalıştıralım. Eğer yerel kurulum yaptıysanız, npx kullanmanız gerekecektir:

npx ts-node src/index.ts

Eğer global kurulum yaptıysanız (veya ts-node PATH’inizde ise):

ts-node src/index.ts

Her iki durumda da çıktıyı terminalinizde görmelisiniz:

Merhaba, Dünya! ts-node ile çalışıyorum.
Veri başarıyla çekildi!

Gördüğünüz gibi, ts-node derleme adımını sizin için otomatik olarak halletti ve kodu doğrudan çalıştırdı.

package.json Scriptleri ile Kullanım

Çoğu Node.js projesinde, betikleri çalıştırmak için package.json dosyasındaki scripts bölümü kullanılır. ts-node‘u bu script’lere entegre etmek, geliştirme sürecini daha da düzenli hale getirir.

package.json dosyanızı açın ve scripts bölümüne bir start veya dev script’i ekleyin:

// package.json
{
  "name": "my-ts-project",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "start": "ts-node src/index.ts",
    "dev": "ts-node --project tsconfig.json src/index.ts",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "ts-node": "^10.9.1",
    "typescript": "^5.2.2"
  }
}

Şimdi betiği aşağıdaki gibi çalıştırabilirsiniz:

npm run start
veya
yarn start

Bu yöntem, projenizdeki diğer geliştiricilerin de aynı komutları kullanarak betikleri çalıştırmasını sağlar ve ts-node‘un yerel kurulumunu otomatik olarak kullanır.

Gelişmiş Kullanım ve Yapılandırma

ts-node, basit kullanımının ötesinde, projenizin ihtiyaçlarına göre özelleştirebileceğiniz birçok gelişmiş seçeneğe sahiptir.

TypeScript Yapılandırması (tsconfig.json)

ts-node, projenizin kök dizininde bulunan tsconfig.json dosyasını otomatik olarak algılar ve içindeki derleyici seçeneklerini (compilerOptions) kullanarak kodu derler. Bu, ts-node‘un projenizin TypeScript ayarlarıyla tam uyumlu çalışmasını sağlar.

Örnek bir tsconfig.json dosyası:

// tsconfig.json
{
  "compilerOptions": {
    "target": "es2020",             / Hedef JavaScript sürümü /
    "module": "commonjs",           / Modül sistemi (Node.js için yaygın) /
    "lib": ["es2020", "dom"],       / Kullanılan kütüphane dosyaları /
    "strict": true,                 / Tüm katı tip kontrol seçeneklerini etkinleştir /
    "esModuleInterop": true,        / CommonJS/ES modülleri arasında uyumluluk /
    "skipLibCheck": true,           / Tüm deklarasyon dosyalarında tip kontrolünü atla /
    "forceConsistentCasingInFileNames": true, / Dosya adlarında büyük/küçük harf tutarlılığını zorla /
    "outDir": "./dist",             / Derlenmiş JS dosyalarının çıkacağı dizin (ts-node tarafından göz ardı edilir) /
    "baseUrl": "./src",             / Modül çözümlemesi için temel URL /
    "paths": {                      / Modül takma adları /
      "@utils/": ["utils/"],
      "@config": ["config/index.ts"]
    }
  },
  "include": [
    "src//.ts"                   / Derlenecek TypeScript dosyalarını dahil et */
  ],
  "exclude": [
    "node_modules",                 / Hariç tutulacak dizinler /
    "/*.spec.ts"
  ]
}

ts-node, outDir gibi çıktıya yönelik ayarları göz ardı eder, çünkü kendisi dosya çıktısı oluşturmaz. Ancak target, module, baseUrl, paths, strict gibi derleme davranışını etkileyen tüm ayarları dikkate alır. Özellikle baseUrl ve paths ayarları, modül çözümlemesi için kritik öneme sahiptir.

ts-node Seçenekleri

ts-node‘u çalıştırırken çeşitli komut satırı seçenekleri veya ortam değişkenleri aracılığıyla davranışını özelleştirebilirsiniz.

* --project veya -P : ts-node‘un belirli bir tsconfig.json dosyasını kullanmasını sağlar. Eğer projenizin kök dizininde birden fazla tsconfig.json varsa veya varsayılanın dışında bir dosya kullanmak istiyorsanız faydalıdır.

npx ts-node --project ./configs/tsconfig.dev.json src/index.ts

* --compiler : Varsayılan TypeScript derleyicisi yerine farklı bir derleyici kullanmanızı sağlar. Örneğin, ttypescript gibi özel dönüştürücülerle (transformers) çalışan bir derleyiciyi kullanabilirsiniz.

npx ts-node --compiler ttypescript src/index.ts

* --require veya -r : Betik çalıştırılmadan önce belirli bir Node.js modülünü yükler. Bu, genellikle source-map-support/register gibi modülleri yüklemek için kullanılır, böylece hata izleri (stack traces) orijinal TypeScript kaynak kodunu gösterir.

npx ts-node --require source-map-support/register src/index.ts

* --transpile-only: Tip kontrolünü atlar ve sadece kodu JavaScript’e dönüştürür. Bu, büyük projelerde başlangıç süresini önemli ölçüde hızlandırabilir, ancak tip güvenliğini garanti etmez. Tip hataları sadece IDE’nizde veya ayrı bir tsc komutu çalıştırdığınızda görünür olacaktır.

npx ts-node --transpile-only src/index.ts

* --esm: Deneysel ES Modülleri (ESM) desteğini etkinleştirir. Node.js’in --experimental-modules bayrağına benzer şekilde çalışır. .mjs veya .mts uzantılı dosyalar için veya package.json içinde "type": "module" belirtilmiş projeler için gereklidir.

node --loader ts-node/esm src/index.ts # Node.js 16+ için önerilen yol
    # veya eski Node.js versiyonları için
    npx ts-node --esm src/index.ts

* --files: tsconfig.json içindeki files dizisinde belirtilen tüm dosyaları zorunlu olarak yükler. Normalde ts-node sadece require edilen dosyaları işler.

* Ortam Değişkenleri ile Yapılandırma: Komut satırı seçeneklerine ek olarak, ts-node‘u ortam değişkenleri aracılığıyla da yapılandırabilirsiniz. Örneğin:
* TS_NODE_PROJECT: --project ile aynı işlevi görür.
* TS_NODE_COMPILER_OPTIONS: tsconfig.json içindeki compilerOptions‘ı geçersiz kılar. JSON formatında bir dize alır.
* TS_NODE_TRANSPHILE_ONLY: --transpile-only ile aynı işlevi görür.

REPL Kullanımı

ts-node‘u herhangi bir dosya adı belirtmeden çalıştırdığınızda, interaktif bir TypeScript REPL oturumu başlatır. Bu, hızlı testler yapmak, TypeScript sözdizimini denemek veya küçük kod parçacıklarını çalıştırmak için harika bir yoldur.

npx ts-node

veya global kurulum yaptıysanız:

ts-node

Ardından terminalinizde TypeScript kodu yazıp anında sonuçlarını görebilirsiniz:

> const message: string = "Merhaba REPL!";
undefined
> console.log(message);
Merhaba REPL!
undefined
> class Greeter { constructor(public name: string) {} greet() { return Hello, ${this.name}!; } }
undefined
> const greeter = new Greeter("TypeScript");
undefined
> greeter.greet();
'Hello, TypeScript!'
> .exit // REPL'den çıkmak için

ts-node ve Modül Çözümlemesi

TypeScript projelerinde, modül çözümlemesi (import veya require ifadelerinin gerçek dosya yollarına dönüştürülmesi) karmaşık bir konu olabilir. Özellikle tsconfig.json içindeki baseUrl ve paths seçenekleri, modül takma adları (alias) tanımlayarak daha temiz içe aktarma yolları oluşturmanıza olanak tanır.

Örneğin, src/utils/math.ts dosyanız varsa ve src/index.ts dosyasından ona @utils/math takma adıyla erişmek istiyorsanız:

// tsconfig.json
{
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@utils/": ["utils/"]
    }
  }
}

// src/utils/math.ts
export function add(a: number, b: number): number {
    return a + b;
}

// src/index.ts
import { add } from '@utils/math'; // Takma ad ile içe aktarma

console.log(2 + 3 = ${add(2, 3)});

ts-node, tsconfig.json dosyanızdaki baseUrl ve paths ayarlarını otomatik olarak yorumlar ve modül çözümlemesini buna göre yapar. Bu, geliştirme sırasında karmaşık içe aktarma yollarıyla uğraşmadan kodunuzu düzenli tutmanızı sağlar. Eğer ts-node modül çözümlemesi ile ilgili sorunlar yaşarsa, tsconfig-paths gibi ek bir paket kullanmanız gerekebilir. Bu paket, Node.js’in modül çözümlemesini tsconfig.json‘daki paths ile uyumlu hale getiren bir require kancası sağlar.

npm install -D tsconfig-paths

Ardından package.json script’inizde veya komut satırında ts-node ile birlikte kullanabilirsiniz:

"scripts": {
  "start": "ts-node -r tsconfig-paths/register src/index.ts"
}

ts-node ile Hata Ayıklama (Debugging)

ts-node, Node.js’in yerleşik hata ayıklama araçlarıyla ve popüler IDE’lerle (özellikle VS Code) sorunsuz bir şekilde entegre olur. Bu, TypeScript kodunuzda doğrudan hata ayıklama yapmanızı sağlar, tıpkı derlenmiş JavaScript kodunda hata ayıklama yapar gibi.

Node.js Hata Ayıklama Protokolü ile:
Node.js, V8 Inspector protokolü aracılığıyla hata ayıklama desteği sunar. ts-node ile bir betiği hata ayıklama modunda çalıştırmak için node komutuna --inspect veya --inspect-brk bayrağını eklemeniz ve ardından ts-node‘u çağırmanız gerekir:

node --inspect-brk npx ts-node src/index.ts

* --inspect-brk: Kodun ilk satırında duraklatır ve hata ayıklayıcının bağlanmasını bekler.
* --inspect: Kodun çalışmasına izin verir ve hata ayıklayıcının istediği zaman bağlanmasına izin verir.

Bu komutu çalıştırdığınızda, terminalinizde bir URL (ws://127.0.0.1:9229/...) göreceksiniz. Bu URL’yi Chrome tarayıcınızın adres çubuğuna yapıştırarak Chrome Geliştirici Araçları’nın hata ayıklayıcısını açabilirsiniz.

VS Code Entegrasyonu:
VS Code, ts-node ile TypeScript betiklerinde hata ayıklama için mükemmel bir deneyim sunar. Projenizin .vscode/launch.json dosyasına bir yapılandırma eklemeniz yeterlidir.

// .vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch ts-node",
      "runtimeArgs": [
        "-r",
        "ts-node/register" // ts-node'u require kancası olarak kaydeder
      ],
      "args": [
        "${workspaceFolder}/src/index.ts" // Çalıştırılacak TypeScript betiği
      ],
      "cwd": "${workspaceFolder}",
      "protocol": "inspector",
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Launch ts-node (npx)",
      "runtimeExecutable": "npx", // npx kullanarak ts-node'u çalıştır
      "runtimeArgs": [
        "ts-node"
      ],
      "args": [
        "${workspaceFolder}/src/index.ts"
      ],
      "cwd": "${workspaceFolder}",
      "protocol": "inspector",
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    }
  ]
}

Bu yapılandırmalardan herhangi birini kullanarak, VS Code’da istediğiniz TypeScript satırına kesme noktaları (breakpoints) koyabilir ve uygulamanızı doğrudan IDE’den çalıştırarak adım adım hata ayıklama yapabilirsiniz. ts-node ve Node.js’in kaynak harita desteği sayesinde, hata ayıklayıcı size orijinal TypeScript kodunuzu gösterecektir.

Sınırlamalar ve Alternatifler

ts-node geliştirme sürecini hızlandırsa da, bazı sınırlamaları ve alternatifleri göz önünde bulundurmak önemlidir.

Sınırlamalar

1. Performans: ts-node kodu anında derlediği için, bu işlem bir miktar ek yük getirir. Büyük projelerde veya sık sık çalıştırılan uzun süreli betiklerde, bu derleme süresi fark edilebilir hale gelebilir. Üretim ortamında performans kritik olduğundan, ts-node genellikle burada kullanılmaz.
2. Tip Kontrolü Yükü: Varsayılan olarak, ts-node kodu derlerken tip kontrolü de yapar. Bu, tip güvenliği için harika olsa da, derleme süresini uzatabilir. --transpile-only bayrağı bu yükü azaltabilir, ancak tip kontrolünü atladığı için olası tip hatalarını çalışma zamanında ortaya çıkarabilir.
3. Bazı Özel Durumlar: Çok karmaşık TypeScript yapılandırmaları, özel derleyici eklentileri veya deneysel TypeScript özellikleri ile ts-node‘un uyumluluğu bazen sorunlu olabilir.

Alternatifler

1. tsc && node (Geleneksel Yaklaşım):
* Avantajları: Üretim için en güvenli ve performanslı yöntemdir. Kodu önceden derler ve sadece saf JavaScript çalıştırır.
* Dezavantajları: Geliştirme döngüsünü yavaşlatır, çünkü her değişiklikte manuel derleme gerektirir.
* Kullanım: tsc && node dist/index.js

2. babel-node:
* Avantajları: Babel ile TypeScript kodunu derleyip çalıştırma yeteneği sunar. JavaScript’in gelecekteki özelliklerini ve diğer dil uzantılarını destekleme esnekliği sağlar.
* Dezavantajları: TypeScript’in kendi derleyicisi gibi tam tip kontrolü sağlamaz. Sadece dönüştürme (transpilation) yapar.
* Kullanım: babel-node src/index.ts (Babel yapılandırması gerektirir)

3. esbuild-register / swc-node:
* Avantajları: Rust dilinde yazılmış esbuild veya SWC gibi ultra hızlı derleyicileri kullanarak TypeScript’i JavaScript’e dönüştürür. ts-node‘dan çok daha hızlıdırlar ve geliştirme süresini daha da kısaltabilirler, özellikle büyük kod tabanlarında.
* Dezavantajları: ts-node kadar olgun olmayabilirler veya TypeScript’in tüm özel derleyici seçeneklerini tam olarak desteklemeyebilirler. Tip kontrolünü genellikle atlayarak sadece dönüştürme yaparlar.
* Kullanım:

# esbuild-register için
        node -r esbuild-register src/index.ts
        # swc-node için
        node -r @swc-node/register src/index.ts

Bu alternatifler, özellikle performansın kritik olduğu veya ts-node‘un yeterince hızlı gelmediği durumlarda değerlendirilmelidir.

En İyi Uygulamalar (Best Practices)

ts-node‘dan en iyi şekilde yararlanmak için bazı en iyi uygulamaları takip etmek faydalıdır:

* Geliştirme Ortamında Kullanın: ts-node‘u geliştirme sürecinizi hızlandırmak için kullanın. Üretim ortamında her zaman tsc ile derlenmiş JavaScript dosyalarını çalıştırın. Bu, hem performansı artırır hem de potansiyel derleme zamanı hatalarını üretimden önce yakalamanızı sağlar.
* package.json Scriptleri ile Entegre Edin: Projenizin tüm geliştirme betiklerini package.json içindeki scripts bölümüne ekleyin. Bu, ekip üyeleri arasında tutarlılık sağlar ve betiklerin kolayca çalıştırılmasını mümkün kılar.
* Yerel Kurulumu Tercih Edin: ts-node ve TypeScript’i projenize yerel olarak kurun (npm install -D ts-node typescript). Bu, bağımlılık çakışmalarını önler ve projenizin farklı Node.js/TypeScript versiyonlarıyla daha esnek olmasını sağlar.
* tsconfig.json Dosyasını Doğru Yapılandırın: ts-node‘un projenizin tip kontrolü ve modül çözümleme ayarlarını doğru bir şekilde uygulayabilmesi için tsconfig.json dosyanızı dikkatlice yapılandırın. Özellikle baseUrl ve paths ayarlarını kullanıyorsanız, tsconfig-paths entegrasyonunu göz önünde bulundurun.
* Performans Sorunları İçin --transpile-only veya Alternatifleri Değerlendirin: Eğer ts-node‘un başlangıç süresi projenizde bir darboğaz haline gelirse, --transpile-only bayrağını kullanarak tip kontrolünü atlayabilirsiniz. Daha ekstrem durumlarda, esbuild-register veya swc-node gibi daha hızlı alternatifleri değerlendirin. Ancak bu durumda tip kontrolünü ayrı bir süreçte (tsc --noEmit) çalıştırmayı unutmayın.
* Hata Ayıklama İçin VS Code Entegrasyonunu Kullanın: VS Code’un launch.json yapılandırmasını kullanarak ts-node ile TypeScript kodunuzda doğrudan ve etkili bir şekilde hata ayıklama yapın.

Sonuç

ts-node, TypeScript geliştiricilerinin hayatını kolaylaştıran, geliştirme döngüsünü önemli ölçüde hızlandıran ve genel geliştirici deneyimini iyileştiren vazgeçilmez bir araçtır. TypeScript kodunu anında JavaScript’e dönüştürerek, tsc && node gibi geleneksel yöntemlerin getirdiği ek adımları ortadan kaldırır. Bu sayede, geliştiriciler daha çok kod yazmaya ve daha az derleme sürecini yönetmeye odaklanabilirler.

Kurulumu basit, kullanımı sezgisel ve Node.js ekosistemiyle derinlemesine entegre olan ts-node, tip güvenliğinden ödün vermeden hızlı prototipleme, betik çalıştırma ve hata ayıklama imkanları sunar. Gelişmiş yapılandırma seçenekleri sayesinde, projenizin özel ihtiyaçlarına göre özelleştirilebilir ve tsconfig.json dosyanızla tam uyumlu çalışır.

Unutulmamalıdır ki, ts-node‘un ana kullanım alanı geliştirme ortamıdır. Üretim ortamlarında performans ve kararlılık için her zaman derlenmiş JavaScript dosyalarını kullanmak en iyi yaklaşımdır. Ancak geliştirme sürecindeki verimlilik artışı göz önüne alındığında, ts-node modern TypeScript projelerinin olmazsa olmaz araçlarından biridir. Bu kılavuz, ts-node‘u projenize entegre etmeniz ve TypeScript betiklerinizi sorunsuz bir şekilde çalıştırmanız için gerekli tüm bilgileri sağlamıştır.