Node.js Kodunu Visual Studio Code’da Hata Ayıklama Rehberi
Giriş: Neden Hata Ayıklama Önemli?
Yazılım geliştirme süreci, kod yazmaktan çok daha fazlasını içerir. Kodun doğru çalıştığından emin olmak, beklenmedik davranışları tespit etmek ve sorunları gidermek, geliştirme döngüsünün ayrılmaz bir parçasıdır. Bu noktada “hata ayıklama” (debugging) devreye girer. Hata ayıklama, bir yazılım uygulamasındaki hataları (bug) bulma ve düzeltme sürecidir. Etkili bir hata ayıklama stratejisi, geliştiricilerin zamanını büyük ölçüde kısaltır, kod kalitesini artırır ve daha sağlam uygulamalar oluşturmalarına olanak tanır.
Node.js, sunucu tarafı JavaScript çalıştırma ortamı olarak hızla popülerlik kazanmıştır. Asenkron yapısı, olay odaklı mimarisi ve geniş modül ekosistemi sayesinde modern web uygulamalarının belkemiğini oluşturur. Ancak bu dinamik yapı, hata ayıklama süreçlerini bazen karmaşık hale getirebilir. Özellikle büyük ölçekli uygulamalarda, asenkron işlemlerin izini sürmek veya veri akışındaki beklenmedik değişiklikleri tespit etmek zorlayıcı olabilir.
Visual Studio Code (VS Code), Node.js geliştiricileri için en popüler ve güçlü IDE’lerden (Entegre Geliştirme Ortamı) biridir. Microsoft tarafından geliştirilen bu hafif ancak zengin özellikli kod düzenleyici, Node.js için yerleşik hata ayıklama desteği sunar. Bu entegrasyon, geliştiricilerin kodlarını doğrudan IDE içinden adım adım çalıştırmalarına, değişken değerlerini incelemelerine ve programın yürütme akışını kontrol etmelerine olanak tanır. Bu makale, Node.js kodunu Visual Studio Code kullanarak nasıl etkili bir şekilde hata ayıklayacağınızı adım adım açıklayacaktır.
Visual Studio Code ve Node.js Entegrasyonu
Visual Studio Code, Node.js ve JavaScript/TypeScript geliştirme için olağanüstü bir deneyim sunar. Bunun temel nedeni, VS Code’un doğrudan Google Chrome’un V8 JavaScript motorunun hata ayıklama protokolü ile iletişim kurabilmesidir. Node.js de V8 motorunu kullandığı için, VS Code bu sayede Node.js uygulamaları üzerinde doğal ve güçlü bir hata ayıklama yeteneği kazanır.
Bu entegrasyonun sunduğu başlıca avantajlar şunlardır:
* Yerleşik Destek: Herhangi bir ek uzantıya ihtiyaç duymadan Node.js kodunuzu hata ayıklayabilirsiniz.
* Zengin Arayüz: Kesme noktaları, değişken izleme, çağrı yığını, hata ayıklama konsolu gibi tüm standart hata ayıklama araçlarına kolayca erişim.
* Gelişmiş Özellikler: Koşullu kesme noktaları, log noktaları, çoklu süreç hata ayıklama gibi gelişmiş yetenekler.
* Hızlı Geri Bildirim: Kodunuzda değişiklik yaptığınızda, genellikle hızlı bir yeniden başlatma ile hata ayıklama oturumunu güncelleyebilirsiniz.
* TypeScript Desteği: TypeScript ile geliştirme yapıyorsanız, kaynak haritalar (source maps) sayesinde dönüştürülmüş JavaScript yerine doğrudan TypeScript kodunuz üzerinde hata ayıklama yapabilirsiniz.
Bu yetenekler, VS Code’u Node.js geliştiricileri için vazgeçilmez bir araç haline getirir.
Temel Hata Ayıklama Konseptleri
Etkili bir hata ayıklayıcı kullanabilmek için bazı temel konseptleri anlamak önemlidir:
* Kesme Noktası (Breakpoint): Kodun belirli bir satırında program yürütmesini geçici olarak durduran bir işaretleyicidir. Bu sayede o noktadaki değişken değerlerini inceleyebilir ve programın o ana kadarki durumunu analiz edebilirsiniz. VS Code’da bir satır numarasının solundaki boşluğa tıklayarak kesme noktası ekleyebilir veya kaldırabilirsiniz.
* Adımlama (Stepping): Program yürütmesini durdurduktan sonra, kodu satır satır ilerletme işlemidir.
* Step Over (Adım Üzerinden Atla): Mevcut satırdaki kodu çalıştırır ve bir sonraki satıra geçer. Eğer mevcut satır bir fonksiyon çağrısı içeriyorsa, fonksiyonun içine girmeden tüm fonksiyonu çalıştırır ve fonksiyonun çağrıldığı satırdan sonraki satıra geçer.
* Step Into (Adım İçine Gir): Mevcut satırdaki kodu çalıştırır. Eğer mevcut satır bir fonksiyon çağrısı içeriyorsa, fonksiyonun tanımının ilk satırına girer ve yürütmeyi oradan devam ettirir.
* Step Out (Adım Dışarı Çık): Mevcut fonksiyonun geri kalanını çalıştırır ve bu fonksiyonun çağrıldığı yere geri döner.
* Continue (Devam Et): Bir sonraki kesme noktasına kadar veya programın sonuna kadar yürütmeye devam eder.
* Değişken İnceleme (Variable Inspection): Hata ayıklama sırasında, belirli bir noktada tanımlanmış tüm değişkenlerin değerlerini görüntüleme yeteneğidir. Bu, programın beklenen duruma sahip olup olmadığını kontrol etmek için hayati öneme sahiptir.
* Çağrı Yığını (Call Stack): Bir programın çalıştığı anda aktif olan tüm fonksiyonların listesidir. Bu, bir hatanın nerede meydana geldiğini ve hangi fonksiyon çağrıları zincirinin o hataya yol açtığını anlamak için çok önemlidir.
* Hata Ayıklama Konsolu (Debug Console): Hata ayıklama sırasında, değişkenleri değerlendirmek, ifadeler çalıştırmak veya program çıktısını görüntülemek için kullanılan etkileşimli bir konsoldur. console.log ifadeleri de burada görünür.
Visual Studio Code’da Hata Ayıklamaya Başlamak
VS Code’da Node.js hata ayıklamayı başlatmanın birkaç yolu vardır. En yaygın ve güçlü yöntem launch.json dosyasını yapılandırmaktır.
launch.json Dosyasını Yapılandırmak
launch.json dosyası, VS Code’un hata ayıklayıcısına uygulamanızı nasıl başlatacağını veya mevcut bir sürece nasıl bağlanacağını bildiren bir yapılandırma dosyasıdır. Bu dosya, projenizin kök dizinindeki .vscode klasöründe bulunur.
1. Hata Ayıklama Görünümünü Açın: VS Code’un sol kenar çubuğundaki “Çalıştır ve Hata Ayıkla” (Run and Debug) simgesine (bir böcek ve oynat düğmesi gibi görünür) tıklayın.
2. launch.json Oluşturun: Henüz bir launch.json dosyanız yoksa, “launch.json dosyası oluştur” (create a launch.json file) bağlantısına tıklayın. VS Code size bir ortam seçmenizi isteyecektir; “Node.js” seçeneğini seçin. Bu, projeniz için temel bir launch.json dosyası oluşturacaktır.
Örnek bir launch.json dosyası aşağıdaki gibi görünebilir:
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Mevcut Dosyayı Çalıştır",
"program": "${file}"
},
{
"type": "node",
"request": "launch",
"name": "Uygulamayı Başlat",
"program": "${workspaceFolder}/src/app.js",
"runtimeArgs": ["--inspect-brk"],
"args": ["--port", "3000"],
"env": {
"NODE_ENV": "development",
"DEBUG_MODE": "true"
},
"cwd": "${workspaceFolder}"
},
{
"type": "node",
"request": "attach",
"name": "Sürece Bağlan",
"port": 9229,
"restart": true
}
]
}Manuel Yapılandırma Adımları
Yukarıdaki launch.json dosyasındaki anahtar alanları açıklayalım:
* type: Hata ayıklayıcının türünü belirtir. Node.js için bu her zaman "node" olacaktır.
* request: Hata ayıklayıcının nasıl davranacağını belirtir.
* "launch": Yeni bir Node.js süreci başlatır ve ona bağlanır.
* "attach": Zaten çalışan bir Node.js sürecine bağlanır.
* name: Hata ayıklama yapılandırmasının VS Code arayüzünde görünen adıdır. Birden fazla yapılandırmanız olduğunda aralarında seçim yapmanızı kolaylaştırır.
* program: "launch" isteği için, çalıştırılacak Node.js ana dosyasının yolunu belirtir. ${workspaceFolder} projenin kök dizinine işaret eder. ${file} ise o an açık olan dosyayı ifade eder.
* args: Node.js betiğine iletilecek komut satırı argümanlarıdır (örneğin, --port 3000).
* runtimeArgs: Node.js çalışma zamanına (V8 motoruna) iletilecek argümanlardır (örneğin, --inspect-brk hata ayıklayıcının kodun en başında durmasını sağlar).
* env: Ortam değişkenlerini ayarlar. Bu, geliştirme, test veya üretim ortamları için farklı yapılandırmalar sağlamak için kullanışlıdır.
* cwd (Current Working Directory): Node.js sürecinin başlatılacağı çalışma dizinidir. Genellikle ${workspaceFolder} olarak ayarlanır.
* port: "attach" isteği için, bağlanılacak Node.js hata ayıklama portunu belirtir (varsayılan genellikle 9229’dur).
* restart: "attach" modunda, Node.js süreci yeniden başlatıldığında hata ayıklayıcının otomatik olarak yeniden bağlanıp bağlanmayacağını belirtir.
Bir yapılandırmayı seçip hata ayıklamayı başlatmak için, Hata Ayıklama görünümündeki açılır menüden istediğiniz yapılandırmayı seçin ve yeşil oynat düğmesine (F5) basın.
Otomatik Yapılandırma (Auto Attach)
VS Code’un son sürümlerinde, launch.json dosyasını manuel olarak yapılandırma ihtiyacını azaltan veya ortadan kaldıran “Auto Attach” özelliği bulunmaktadır. Bu özellik, VS Code’un terminalinde başlatılan Node.js süreçlerini otomatik olarak algılar ve bunlara bağlanır.
Auto Attach’i etkinleştirmek için:
1. VS Code ayarlarını açın (Ctrl+, veya Command+,).
2. Arama çubuğuna debug.node.autoAttach yazın.
3. Bu ayarı on olarak değiştirin. Alternatif olarak, processWithInspect veya onlyWithFlag gibi daha spesifik seçenekleri de tercih edebilirsiniz.
* on: Herhangi bir Node.js sürecine otomatik olarak bağlanır.
* processWithInspect: Sadece --inspect veya --inspect-brk bayrağı ile başlatılan Node.js süreçlerine bağlanır.
* onlyWithFlag: Yalnızca bir Node.js betiği --inspect veya --inspect-brk bayrağıyla başlatıldığında otomatik olarak bağlanır.
Auto Attach etkinleştirildiğinde, VS Code terminalinde node app.js veya npm run dev gibi bir komutla Node.js uygulamanızı başlattığınızda, hata ayıklayıcı otomatik olarak sürece bağlanacaktır. Bu, hızlı testler ve basit uygulamalar için son derece kullanışlıdır.
Hata Ayıklama Arayüzü: Bileşenler ve Kullanım
Hata ayıklama oturumu başladığında, VS Code’un sol kenar çubuğundaki Hata Ayıklama görünümü (Run and Debug) ve üstteki hata ayıklama kontrol çubuğu aktif hale gelir.
Değişkenler (Variables) Paneli
Bu panel, mevcut kapsamdaki tüm değişkenlerin değerlerini gösterir. Program bir kesme noktasında durduğunda, “Local” (Yerel), “Global” (Genel) ve “Closure” (Kapanım) gibi kategoriler altında değişkenleri görebilirsiniz. Değişkenlerin değerlerini genişleterek nesnelerin ve dizilerin içeriğini inceleyebilirsiniz. Hata ayıklama sırasında değişken değerlerini doğrudan değiştirmek de mümkündür, bu da farklı senaryoları test etmek için kullanışlıdır.
İzleme (Watch) Paneli
İzleme paneli, belirli değişkenlerin veya ifadelerin değerlerini sürekli olarak takip etmenizi sağlar. Bir değişken veya ifade eklediğinizde, programın yürütmesi sırasında değeri her değiştiğinde güncellenir. Bu, karmaşık ifadelerin veya belirli bir değişkendeki değişikliklerin neden olduğu sorunları anlamak için çok faydalıdır. İzleme paneline bir ifade eklemek için + düğmesine tıklayın ve ifadeyi yazın.
Çağrı Yığını (Call Stack) Paneli
Çağrı yığını paneli, programın mevcut yürütme noktasında hangi fonksiyonların birbirini çağırdığını gösterir. Her bir öğe, bir fonksiyon çağrısını temsil eder ve üstteki öğe en son çağrılan fonksiyonu (mevcut yürütme noktası), alttaki öğe ise ilk çağrılan fonksiyonu gösterir. Bu panel, bir hatanın kökenini bulmak ve programın akışını anlamak için kritik öneme sahiptir. Yığındaki herhangi bir öğeye tıklayarak, o fonksiyonun çağrıldığı koda atlayabilir ve o andaki yerel değişkenleri inceleyebilirsiniz.
Kesme Noktaları (Breakpoints) Paneli
Bu panel, projenizdeki tüm etkin ve devre dışı bırakılmış kesme noktalarını listeler. Buradan kesme noktalarını tek tek etkinleştirebilir veya devre dışı bırakabilir, silebilir veya tümünü devre dışı bırakabilirsiniz. Ayrıca, “Uncaught Exceptions” (Yakalanmayan İstisnalar) ve “Caught Exceptions” (Yakalanan İstisnalar) için özel durum kesme noktalarını da burada yönetebilirsiniz.
Hata Ayıklama Konsolu (Debug Console)
Hata ayıklama konsolu, iki ana amaç için kullanılır:
1. Çıktıyı Görüntüleme: console.log(), console.error() gibi Node.js çıktılarının yanı sıra, hata ayıklayıcının kendi mesajlarını da gösterir.
2. İfade Değerlendirme: Program bir kesme noktasında durduğunda, konsola herhangi bir JavaScript ifadesi yazabilir ve anında sonucunu görebilirsiniz. Örneğin, myVariable yazıp Enter’a basarak myVariable‘ın o anki değerini görebilirsiniz. Veya myObject.property = 'newValue' yazarak bir değişkenin değerini değiştirebilirsiniz. Bu, anlık testler yapmak ve programın durumunu değiştirmek için çok güçlü bir araçtır.
Gelişmiş Hata Ayıklama Teknikleri
VS Code, temel hata ayıklama özelliklerinin ötesinde, daha karmaşık senaryolar için geliştirilmiş teknikler sunar.
Koşullu Kesme Noktaları (Conditional Breakpoints)
Bazen bir döngü içinde veya sık çağrılan bir fonksiyonda sadece belirli bir koşul sağlandığında durmak isteyebilirsiniz. Koşullu kesme noktaları tam da bu işe yarar.
Bir koşullu kesme noktası eklemek için:
1. Normal bir kesme noktası eklediğiniz gibi satır numarasının soluna tıklayın.
2. Eklediğiniz kesme noktasına sağ tıklayın ve “Kesme Noktasını Düzenle” (Edit Breakpoint) seçeneğini seçin.
3. Açılan küçük pencereye bir JavaScript ifadesi yazın (örneğin, i === 10 veya user.id === 'some-id').
4. Enter’a basın.
Program sadece belirttiğiniz koşul true döndüğünde bu kesme noktasında duracaktır. Bu, özellikle büyük veri kümeleriyle çalışırken veya belirli bir durumun neden olduğu bir hatayı ararken çok zaman kazandırır.
Log Noktaları (Logpoints)
Log noktaları, kodunuza geçici console.log ifadeleri eklemenin bir yoludur, ancak kodu gerçekten değiştirmenize gerek kalmaz. Bu, özellikle bir değeri takip etmek istediğinizde ancak programın durmasını istemediğinizde kullanışlıdır.
Bir log noktası eklemek için:
1. Normal bir kesme noktası eklediğiniz gibi satır numarasının soluna tıklayın.
2. Eklediğiniz kesme noktasına sağ tıklayın ve “Logpoint Ekle” (Add Logpoint) seçeneğini seçin.
3. Açılan küçük pencereye bir mesaj veya ifade yazın (örneğin, 'Döngüde i değeri: ' + i veya user.name).
4. Enter’a basın.
Program bu noktadan geçtiğinde, belirtilen mesaj veya ifadenin değeri Hata Ayıklama Konsolu’nda görüntülenecektir, ancak program durmayacaktır.
Özel Durum Kesme Noktaları (Exception Breakpoints)
Bu tür kesme noktaları, bir istisna (hata) fırlatıldığında programın durmasını sağlar. Bu, beklenmedik hataları yakalamak ve kök nedenini anlamak için çok önemlidir.
Hata Ayıklama görünümündeki Kesme Noktaları panelinde “Uncaught Exceptions” (Yakalanmayan İstisnalar) ve “Caught Exceptions” (Yakalanan İstisnalar) seçeneklerini göreceksiniz. Bunları işaretleyerek, Node.js uygulamanızda fırlatılan istisnalarda hata ayıklayıcının durmasını sağlayabilirsiniz.
* Uncaught Exceptions: Try-catch bloğu tarafından yakalanmayan istisnalarda durur.
* Caught Exceptions: Try-catch bloğu tarafından yakalanan istisnalarda bile durur. Bu, bir istisnanın neden fırlatıldığını görmek istediğinizde kullanışlıdır, ancak genellikle çok fazla durmaya neden olabileceği için dikkatli kullanılmalıdır.
Fonksiyonel Kesme Noktaları (Function Breakpoints)
Bazen bir fonksiyonun tam olarak nerede tanımlandığını bilmeyebilirsiniz veya dinamik olarak yüklenen modüllerdeki fonksiyonlarda durmak isteyebilirsiniz. Fonksiyonel kesme noktaları, belirli bir fonksiyon adına ulaşıldığında durmanızı sağlar.
Fonksiyonel kesme noktası eklemek için:
1. Kesme Noktaları panelindeki + düğmesine tıklayın.
2. “Fonksiyonel Kesme Noktası” (Function Breakpoint) seçeneğini seçin.
3. Açılan metin kutusuna fonksiyonun adını yazın (örneğin, myUtilityFunction).
Program bu isimdeki bir fonksiyona girdiğinde duracaktır.
Attach Modu ile Hata Ayıklama
Daha önce de bahsettiğimiz gibi, attach modu zaten çalışan bir Node.js sürecine bağlanmanızı sağlar. Bu, özellikle uzun süredir çalışan bir sunucu uygulamasını veya bir npm run dev komutuyla başlatılmış bir süreci hata ayıklamak istediğinizde kullanışlıdır.
Bir Node.js sürecini attach modunda hata ayıklanabilir hale getirmek için, genellikle --inspect veya --inspect-brk bayrağı ile başlatmanız gerekir:
node --inspect-brk my-server.js* --inspect: Node.js sürecini hata ayıklama modunda başlatır ve hata ayıklayıcının bağlanmasını bekler. Süreç çalışmaya devam eder.
* --inspect-brk: Node.js sürecini hata ayıklama modunda başlatır ve kodun ilk satırında durur, hata ayıklayıcının bağlanmasını bekler. Bu, başlangıç sorunlarını yakalamak için idealdir.
Ardından, launch.json dosyanızda "request": "attach" ve uygun "port" (varsayılan 9229) ile bir yapılandırma oluşturarak veya Auto Attach’i kullanarak sürece bağlanabilirsiniz.
Çoklu Süreçlerde Hata Ayıklama (Multi-process Debugging)
Mikroservis mimarileri veya birden fazla Node.js sürecinin aynı anda çalıştığı uygulamalar için VS Code, çoklu süreç hata ayıklamasını destekler. launch.json dosyasında compound yapılandırmasını kullanarak birden fazla hata ayıklama oturumunu aynı anda başlatabilirsiniz.
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "API Servisi",
"program": "${workspaceFolder}/services/api/index.js",
"port": 9229
},
{
"type": "node",
"request": "launch",
"name": "Kullanıcı Servisi",
"program": "${workspaceFolder}/services/user/index.js",
"port": 9230
}
],
"compounds": [
{
"name": "Tüm Servisleri Başlat",
"configurations": ["API Servisi", "Kullanıcı Servisi"]
}
]
}Bu örnekte, “Tüm Servisleri Başlat” bileşik yapılandırmasını seçip başlattığınızda, hem “API Servisi” hem de “Kullanıcı Servisi” aynı anda hata ayıklama modunda başlatılacaktır. Her bir servis kendi hata ayıklama oturumuna sahip olacak ve VS Code arayüzünde bunlar arasında geçiş yapabileceksiniz.
Otomatik Yeniden Başlatma ile Hata Ayıklama (nodemon entegrasyonu)
Geliştirme sırasında kodda yaptığınız her değişiklikten sonra sunucuyu manuel olarak yeniden başlatmak sıkıcı olabilir. nodemon gibi araçlar bu süreci otomatikleştirir. launch.json dosyanızı nodemon ile entegre ederek hem otomatik yeniden başlatma hem de hata ayıklama avantajlarından faydalanabilirsiniz.
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Nodemon ile Hata Ayıkla",
"runtimeExecutable": "nodemon",
"program": "${workspaceFolder}/src/app.js",
"restart": true,
"console": "integratedTerminal",
"internalConsoleOptions": "neverOpen",
"args": ["--inspect=9229"]
}
]
}Bu yapılandırmada:
* runtimeExecutable: Node.js yerine nodemon‘u çalıştırılacak yürütülebilir dosya olarak belirtiriz.
* program: nodemon‘un çalıştıracağı ana Node.js dosyasını belirtir.
* restart: nodemon süreci yeniden başlatıldığında VS Code hata ayıklayıcısının da yeniden bağlanmasını sağlar.
* args: nodemon‘a --inspect=9229 argümanını vererek, Node.js sürecini hata ayıklama modunda başlatmasını söyleriz.
Bu sayede, kodunuzu kaydettiğinizde nodemon uygulamanızı yeniden başlatacak ve VS Code hata ayıklayıcısı otomatik olarak yeni sürece bağlanacaktır.
Async/Await Kodunda Hata Ayıklama
Node.js’in asenkron doğası ve async/await kullanımı, hata ayıklamayı bazen zorlaştırabilir. Geleneksel olarak, bir Promise zincirindeki hataları izlemek karmaşıktı. Ancak VS Code’un V8 entegrasyonu sayesinde, async/await kodunda hata ayıklama oldukça sorunsuz hale gelmiştir. Kesme noktaları, await ifadelerinin hemen öncesine ve sonrasına yerleştirilebilir ve çağrı yığını, asenkron çağrıları da gösterecek şekilde daha anlamlı bilgiler sunar.
Önemli olan, Promise‘ların catch bloklarını doğru bir şekilde kullanmak ve hataları uygun yerlerde yakalamaktır. Hata ayıklama sırasında, Promise‘ların durumlarını (pending, fulfilled, rejected) ve değerlerini değişkenler panelinde veya izleme panelinde takip edebilirsiniz.
Sık Karşılaşılan Sorunlar ve Çözümleri
* Kesme Noktaları Çalışmıyor:
* Sorun: Kodunuzda kesme noktası var ama program durmuyor.
* Çözüm:
* Doğru launch.json yapılandırmasını seçtiğinizden emin olun.
* Programın gerçekten o koda ulaştığından emin olun.
Eğer TypeScript veya Babel gibi bir transpiler kullanıyorsanız, source maps (kaynak haritaları) doğru yapılandırılmış olmalıdır. tsconfig.json dosyanızda sourceMap: true ve outDir ayarlarının doğru olduğundan emin olun. launch.json içinde outFiles ayarını da kontrol edin (örneğin, "outFiles": ["${workspaceFolder}/dist//.js"]).
* VS Code’un Node.js hata ayıklama uzantısının güncel olduğundan emin olun.
* Bazen basit bir VS Code yeniden başlatması sorunu çözebilir.
* launch.json Hataları:
* Sorun: program yolu yanlış, ortam değişkenleri uygulanmıyor, vb.
* Çözüm: Yolları dikkatlice kontrol edin. Mutlak yollar yerine ${workspaceFolder} gibi değişkenleri kullanın. launch.json dosyasında syntax hataları olmadığından emin olun.
* Performans Sorunları:
* Sorun: Hata ayıklama oturumu yavaş çalışıyor veya takılıyor.
* Çözüm: Çok fazla kesme noktası eklemek performansı etkileyebilir. Gereksiz kesme noktalarını kaldırın veya koşullu kesme noktaları ve log noktaları kullanın.
* Attach Modu Bağlanmıyor:
* Sorun: Çalışan Node.js sürecine bağlanılamıyor.
* Çözüm:
* Node.js sürecini --inspect veya --inspect-brk bayrağı ile başlattığınızdan emin olun.
* launch.json dosyasındaki port ayarının, Node.js sürecinin dinlediği port ile aynı olduğundan emin olun.
* Güvenlik duvarı ayarlarını kontrol edin, portun engellenmediğinden emin olun.
* Değişken Değerleri Gösterilmiyor:
* Sorun: Kesme noktasında durulmasına rağmen değişkenler paneli boş veya yanlış değerler gösteriyor.
* Çözüm: Kapsam sorunları olabilir. Değişkenin tanımlandığı ve erişilebilir olduğu kapsamda olduğunuzdan emin olun. Bazen optimizasyonlar nedeniyle bazı değişkenler hata ayıklayıcı tarafından görülemeyebilir; bu durumda, değişkeni bir console.log ile yazdırarak veya log noktası kullanarak kontrol etmeyi deneyin.
Performans İpuçları ve En İyi Uygulamalar
* Sourcemap Kullanımı: Eğer TypeScript, Babel veya başka bir dönüştürücü kullanıyorsanız, source maps oluşturmayı ve bunları launch.json dosyanızda outFiles ile doğru şekilde yapılandırmayı unutmayın. Bu, dönüştürülmüş JavaScript yerine orijinal kodunuz üzerinde hata ayıklama yapmanızı sağlar.
* Hedef Odaklı Hata Ayıklama: Tüm uygulamayı adım adım çalıştırmak yerine, sorunun olabileceği şüpheli alanlara doğrudan kesme noktaları yerleştirin.
* Koşullu Kesme Noktaları ve Log Noktalarını Kullanın: Özellikle döngülerde veya sık çağrılan fonksiyonlarda, programın durmasını istemediğiniz durumlarda bu özellikler çok değerlidir.
* Hata Ayıklama Konsolunu Etkin Kullanın: Değişken değerlerini anında sorgulamak veya ifadeleri çalıştırmak için konsolu kullanmak, sürekli kesme noktası ekleyip kaldırmaktan daha hızlıdır.
* debugger; İfadesi: Bazen bir kesme noktası eklemek yerine doğrudan kodunuza debugger; ifadesini yazabilirsiniz. Bu ifadeye ulaşıldığında, hata ayıklayıcı otomatik olarak duracaktır. Özellikle hızlı testler için veya bir kesme noktasının sürekli silinip eklenmesi yerine geçici bir çözüm olarak kullanılabilir. Ancak üretim koduna gitmemesine dikkat edin.
* Küçük, İzole Test Senaryoları: Karmaşık hataları ayıklamak için, sorunu yeniden üreten en küçük kod parçasını izole etmeye çalışın. Bu, sorunu anlamayı ve çözmeyi kolaylaştırır.
* Versiyon Kontrolü: Hata ayıklama sırasında kodda yaptığınız değişiklikleri versiyon kontrol sistemi (Git gibi) ile takip edin. Bazen bir değişikliğin başka bir hataya neden olduğunu fark edebilirsiniz.
Sonuç
Node.js kodunu Visual Studio Code’da hata ayıklamak, modern geliştirme süreçlerinin vazgeçilmez bir parçasıdır. VS Code’un güçlü ve entegre hata ayıklama yetenekleri sayesinde, karmaşık Node.js uygulamalarındaki hataları tespit etmek, anlamak ve düzeltmek hiç bu kadar kolay olmamıştı. Temel kesme noktalarından, koşullu kesme noktalarına, log noktalarına, çoklu süreç hata ayıklamasına ve otomatik yeniden başlatma entegrasyonuna kadar geniş bir araç yelpazesi sunulmaktadır.
Bu makalede ele alınan teknikleri ve en iyi uygulamaları benimseyerek, geliştirme verimliliğinizi artırabilir, daha sağlam ve hatasız Node.js uygulamaları oluşturabilirsiniz. Unutmayın, hata ayıklama sadece bir sorunu çözmekten ibaret değildir; aynı zamanda kodunuzu daha derinlemesine anlamanıza ve daha iyi bir geliştirici olmanıza yardımcı olan bir öğrenme sürecidir. Pratik yaparak ve VS Code’un sunduğu tüm özellikleri keşfederek, hata ayıklama becerilerinizi sürekli olarak geliştirebilirsiniz. Mutlu hata ayıklamalar!