Express ile TypeScript Kurulumu Nasıl Yapılır

Express ile TypeScript Kurulumu adımlarını keşfedin. Gerekli paketleri yükleyin, TypeScript yapılandırmasını hazırlayın ve ilk Express sunucunuzu çalıştırın.

Express projenizi JavaScript ile geliştirmeye başladınız ancak uygulama büyüdükçe değişkenlerin hangi verileri kabul ettiğini takip etmek zorlaşıyor mu? Özellikle API geliştirirken yanlış veri türleri, fark edilmesi güç hatalara neden olabiliyor. Express ile TypeScript Kurulumu, bu tür sorunları geliştirme aşamasında belirlemek ve kodun daha düzenli ilerlemesini sağlamak isteyenler için kullanışlı bir seçenek.

TypeScript kullanmak için mevcut JavaScript bilginizi bir kenara bırakmanız gerekmiyor. Birkaç paket kurulumu ve yapılandırma değişikliğiyle Express uygulamanızı TypeScript desteğine kavuşturabilirsiniz. Üstelik Windows, macOS ve Linux üzerinde temel işlemler büyük ölçüde aynı. Önemli olan dosya yapısını doğru oluşturmak ve derleyicinin nasıl çalıştığını anlamak.

Henüz Express ortamınız hazır değilse Express Kurulumu: Windows, macOS ve Linux’ta Nasıl Yapılır içeriğindeki temel hazırlıkları inceleyebilirsiniz. Node.js sürümünü kontrol etmek ve npm komutlarını tanımak, sonraki aşamalarda karşılaşabileceğiniz kurulum hatalarını anlamanızı kolaylaştıracaktır.

Express ile TypeScript Kurulumu Nasıl Gerçekleştirilir?

Express ile TypeScript Kurulumu için bilgisayarınızda Node.js ve npm bulunmalıdır. Önce yeni bir Node.js projesi oluşturulur, ardından Express, TypeScript ve gerekli tür tanımları yüklenir. tsconfig.json dosyasında derleme ayarları yapılandırılır. TypeScript kodu JavaScript’e dönüştürüldükten sonra uygulama Node.js üzerinden çalıştırılır ve tarayıcıda test edilir.

1. Node.js ve npm Sürümlerini Kontrol Edin

İlk olarak terminali açın. Windows üzerinde PowerShell, macOS ve Linux üzerinde Terminal kullanabilirsiniz.

node -v
npm -v

Her iki komut da sürüm bilgisi döndürüyorsa kuruluma devam edebilirsiniz. Komut tanınmıyorsa Node.js kurulumunu veya PATH yapılandırmasını kontrol etmelisiniz.

2026 itibarıyla Express 5, Node.js 18 ve üzerini gerektiriyor. Yeni projelerde güncel ve desteklenen bir LTS sürümünü tercih etmek daha uygun olacaktır.

2. Yeni Bir Express Projesi Oluşturun

Express ile TypeScript Kurulumu için öncelikle çalışma klasörünü hazırlayın.

mkdir express-typescript
cd express-typescript
npm init -y

Son komut, proje bilgilerini içeren package.json dosyasını oluşturur. Burada uygulamanın adı, sürümü, bağımlılıkları ve çalıştırma komutları tutulur.

Express ile ortam değişkenlerini yönetmek için dotenv paketini yükleyin.

npm install express dotenv

Express, HTTP isteklerinin karşılanmasını sağlarken dotenv yapılandırma bilgilerini ayrı bir dosyada saklamanıza yardımcı olur.

3. TypeScript ve Tür Tanımlarını Yükleyin

Sıradaki işlem geliştirme araçlarının eklenmesi.

npm install -D typescript @types/express @types/node

Buradaki -D parametresi paketleri geliştirme bağımlılığı olarak kaydeder.

TypeScript Nedir? JavaScript üzerine tür denetimi ekleyen bir programlama dilidir. Kodun derlenmesi sırasında bazı hataların yakalanmasını sağlar. Ancak çalışma zamanındaki bütün hataları otomatik olarak engellemez.

@types/express ve @types/node paketleri, Express ve Node.js API’lerinin TypeScript tarafından tanınmasını sağlar.

Not: Güncel paket belgelerini incelerken dikkatimi çeken ayrıntı, bazı eski kurulum anlatımlarında @types/dotenv paketinin de önerilmesiydi. Oysa dotenv kendi TypeScript tanımlarını içeriyor. Bu nedenle ayrıca tür paketi yüklemek gerekmiyor.

4. TypeScript Yapılandırmasını Hazırlayın

Express ile TypeScript Kurulumu sırasında dosyaların nereye derleneceğini belirlemek gerekiyor.

npx tsc --init

Bu işlem tsconfig.json dosyasını oluşturur. Dosyanın içeriğini aşağıdaki yapılandırmayla düzenleyebilirsiniz.

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "CommonJS",
    "moduleResolution": "node",
    "rootDir": "./src",
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*.ts"]
}

Burada rootDir kaynak dosyaların konumunu, outDir ise derlenen JavaScript dosyalarının yerini belirler.

strict daha sıkı tür denetimi gerçekleştirirken esModuleInterop, kullanılan modül yapısında Express gibi paketlerin içe aktarılmasını kolaylaştırır.

Bu örnek CommonJS çıktısı üretir. ES modülleri kullanan projelerde ayarların farklılaştırılması gerekir.

TypeScript ile Express Sunucusu Nasıl Oluşturulur?

Yapılandırma tamamlandığında uygulamanın ilk dosyasını hazırlayabilirsiniz.

5. Sunucu Dosyasını Oluşturun

Proje içerisinde src klasörü açın ve buraya index.ts dosyasını ekleyin.

Ardından proje ana dizininde .env dosyası oluşturup şu değeri yazın:

PORT=3000

src/index.ts dosyasına aşağıdaki kodları ekleyin.

import express, { type Request, type Response } from 'express';
import 'dotenv/config';

const app = express();
const PORT = Number(process.env.PORT) || 3000;

app.get('/', (req: Request, res: Response) => {
  res.status(200).send('Merhaba TypeScript!');
});

app.listen(PORT, () => {
  console.log(`Sunucu ${PORT} portunda çalışıyor`);
});

Bu örnekte Express uygulaması oluşturulur ve ana adrese gelen GET isteği için bir yanıt tanımlanır.

Request ile Response, istek ve yanıt nesnelerinin türlerini belirtir. process.env.PORT ise .env dosyasındaki port bilgisini okur.

6. Express ile TypeScript Kurulumu Sonrasında Sunucuyu Çalıştırın

TypeScript dosyası doğrudan derlenmiş JavaScript dosyası değildir. Hazırladığımız yapılandırmada önce derleme işlemi yapılmalıdır.

npx tsc

İşlem başarılıysa dist klasöründe index.js oluşur. Sunucuyu başlatın.

node dist/index.js

Tarayıcınızın adres çubuğuna http://localhost:3000 yazın.

Ekranda Merhaba TypeScript! mesajını görüyorsanız ilk Express endpoint’iniz çalışıyor demektir.

7. Çalıştırma Komutlarını Kolaylaştırın

Her değişiklikten sonra uzun komutlar yazmak yerine package.json içerisindeki scripts alanına şu değerleri ekleyebilirsiniz:

"scripts": {
  "build": "tsc",
  "start": "node dist/index.js"
}

Artık derleme için npm run build, uygulamayı başlatmak için npm start kullanabilirsiniz. Kaynak kod değiştiğinde yeniden derleme yapmanız gerektiğini unutmayın.

Express ile TypeScript Kurulumu Hataları Nasıl Giderilir?

Kurulumun doğru görünmesine rağmen sunucu başlamıyorsa önce terminal çıktısını inceleyin.

• Cannot find module: Paketlerin kurulu olduğunu ve derleme dosyasının oluştuğunu kontrol edin.
• Port already in use: 3000 numaralı portu kullanan uygulamayı kapatın veya .env üzerinden farklı port belirleyin.
• TypeScript tür hataları: Eksik tür tanımlarını ve tsconfig.json ayarlarını gözden geçirin.
• Tarayıcı yanıt vermiyor: Sunucunun çalıştığından ve doğru adrese bağlandığınızdan emin olun.

Express ile TypeScript Kurulumu tamamlandıktan sonra aynı yapı üzerinde yeni API uç noktaları oluşturabilir, kodu farklı dosyalara ayırarak geliştirmeye devam edebilirsiniz.

Kurulum sırasında bilgisayar ayarları veya yazılım kaynaklı sorunlarla karşılaşırsanız 11858 üzerinden teknik destek alabilirsiniz. 2011 yılından beri Türkiye genelinde 7/24 hizmet sunan ekip, TeamViewer ve AnyDesk gibi lisanslı araçlarla uzaktan destek sağlar. Dakika bazlı şeffaf ücretlendirme sunan hizmet, yüzde 95 memnuniyet oranı ve 500.000’den fazla başarılı işlem deneyimiyle faaliyetlerini sürdürüyor.

Geliştirme ortamınızı hazırladıktan sonra tarayıcı tarafındaki işlerinizi de kolaylaştırmak isteyebilirsiniz. Özellikle birden fazla web projesiyle ilgileniyorsanız WordPress İçin Chrome Eklentileri: Verimliliği Artıran En İyi Seçenekler içeriğinde günlük çalışma sürecini destekleyen araçları inceleyebilirsiniz.

Express ile TypeScript Kurulumu, kod büyüdükçe değişiklikleri daha kontrollü yönetebilmek için sağlam bir başlangıç sunuyor. Siz TypeScript’i sıfırdan oluşturduğunuz projelerde mi kullanıyorsunuz, yoksa mevcut bir Express uygulamasına mı eklemeyi düşünüyorsunuz? Deneyimlerinizi yorumlarda paylaşabilirsiniz.