GÜNDEMDE

DÜNYADAN TEKNOLOJİ HABERLERİ

→
Yazılım2012 / DÖNEM YAZISI

2012'ye bakış: jQuery, AJAX ve bitmeyen 'neden çalışmıyor?' sorusu

Geliştiricinin 2012 araç çantasında jQuery, XMLHTTPRequest ve tarayıcı konsolu vardı. Hata ayıklamaya dönemin bakışını inceliyoruz.

Yazılımcının GünlüğüYayımlanma: 15 Kas 20266 dk okuma

Örnek dönem tarihi: 21 Nis 2012. Bu içerikler ilgili dönemi bugünden değerlendiren editöryal arşiv yazılarıdır; geçmişte yayımlanmış kayıt olarak sunulmaz.

Küçük bir web uygulamasının büyük derdi

2012 çevresindeki web projelerinde sayfa yenilenmeden veri yüklemek önemli bir kullanıcı deneyimi iyileştirmesiydi. jQuery, farklı tarayıcı davranışlarıyla uğraşan geliştiricilerin işini kolaylaştırıyordu. Ancak AJAX isteği başarısız olduğunda problemi bulmak hâlâ sistematik kontrol gerektiriyordu: ağ sekmesindeki durum kodu, gönderilen parametreler, sunucunun verdiği içerik türü ve beklenen JSON biçimi tek tek incelenmeliydi.

Kavramsal iş akışı — editöryal çizim

Başarısızlık durumunu görünür kılmak

Geliştirici yalnızca 'success' işleyicisini yazdığında sunucu hata döndürse bile kullanıcı ekranda hiçbir şey görmeyebilirdi. İstek zaman aşımı, HTTP hata kodu ve bağlantı kesilmesi için ayrı durum mesajları tasarlamak önemliydi. Sunucudan dönen HTML hata sayfasını JSON gibi ayrıştırmaya çalışmak da sık rastlanan bir sorun türüydü.

Bugün ne değişti, ne değişmedi?

Fetch API, modern çerçeveler ve gözlemlenebilirlik sistemleri eklendi. Fakat teşhis yöntemi aynı kaldı: ağ kaydını aç, gerçek yanıtı incele, varsayımı küçük bir örnekle test et. Bu metin 2012'de yayımlanmış eski bir yazı değil, 2012 geliştirme pratiğinin bugünden hazırlanmış bir dönem incelemesidir.

Önce problemi tekrar üret: tarayıcı, URL, yanıt

İyi hata ayıklama rastgele kod değiştirmekle değil tekrar üretilebilir gözlemle başlar. 2012 döneminde geliştirici sayfayı açar, tarayıcının geliştirici araçlarını etkinleştirir ve başarısız AJAX isteğinin zamanını kaydederdi. İsteğin gerçek adresi, kullanılan HTTP yöntemi, sunucu yanıtı ve tarayıcı konsolundaki mesaj aynı olayı farklı açılardan gösterirdi. Örneğin bir düğmeye iki kez tıklayınca iki POST gönderiliyorsa sorunu yalnızca sunucu tarafında aramak yerine çift bağlanmış olay işleyicisine bakmak gerekir. Testi belirli bir sırayla yaparsanız bir sonraki değişikliğin işe yarayıp yaramadığını da güvenilir biçimde görebilirsiniz.

HTTP 200 her zaman başarı değildir

Sunucu bir hata sayfası oluşturup HTTP 200 döndürdüğünde JavaScript açısından bağlantı başarılı görünür; fakat beklenen iş tamamlanmamış olabilir. Benzer şekilde 302 yönlendirmesi giriş ekranına gittiğinde gelen HTML bir JSON ayrıştırıcısına verilirse alakasız bir sözdizimi hatası oluşur. İsteğin yanıt gövdesi ile durum kodunu birlikte okuyun. 401 yetkisiz, 403 yasak, 404 bulunamadı, 429 sınır aşıldı ve 500 sunucu hatası ayrımı kullanıcıya doğru mesajı göstermeyi sağlar. Başarılı işlem için veri yapısını ve gerekiyorsa kayıt sürümünü ayrıca kontrol edin.

jQuery.ajax hata işleyicisi nasıl kurulur?

Aşağıdaki örnek, dönemin jQuery yaklaşımına uygun bir temel akış gösterir. Zaman aşımı belirlenir, JSON beklenir ve hem ağ hataları hem ayrıştırma problemleri görünür hâle getirilir. Bu gösterim bir 2012 kod tabanından alınmış gerçek arşiv kaydı değildir; günümüzden hazırlanmış, o dönemin API biçimine sadık öğretici bir örnektir. Üretim uygulamasında kullanıcıya ham sunucu hata metnini göstermek yerine anlaşılır, güvenli bir mesaj dönülmelidir.

$.ajax({
  url: '/api/products', type: 'GET', dataType: 'json',
  timeout: 8000,
  success: function(data) {
    if (!data || !data.items) { showError('Bad response'); return; }
    renderProducts(data.items);
  },
  error: function(xhr, status) {
    console.error('AJAX', xhr.status, status);
    showError('Request failed. Please try again.');
  }
});

Önbellek, karakter kodlaması ve aynı kaynak ilkesi

Eski web projelerinde beklenmeyen sonuçların kaynağı her zaman JavaScript mantığı değildi. Tarayıcının önbelleğindeki eski betik yeni sunucu yanıtıyla uyumsuz çalışabilir, hatalı Content-Type başlığı JSON yorumunu değiştirebilirdi. Başka bir alan adına istek yapılırken aynı kaynak ilkesi nedeniyle erişim reddedilebilirdi; JSONP gibi dönem çözümleri güvenlik ve mimari sınırlar içeriyordu. İlk teşhiste dosyanın gerçekten güncel olup olmadığını, yanıt başlıklarını, çerezleri ve isteğin hangi etki alanından gönderildiğini kontrol etmek, gereksiz kod değişikliklerini azaltır.

Bir hatayı küçük deneylere bölmek

Ekranda liste hiç görünmüyorsa önce API yanıtını tek başına deneyin. Ardından yanıtı tarayıcı konsolunda kaydedip şema beklentisiyle karşılaştırın. Veriler geliyorsa render işlevini sabit örnek veriyle çalıştırın. Böylece ağ, uygulama iş kuralları ve DOM güncelleme problemleri birbirinden ayrılır. Bir form gönderiminde tekrar eden kayıtlar oluşuyorsa çift istek, yeniden deneme ve veritabanı benzersizlik kısıtları ayrı ayrı incelenmelidir. Bu yaklaşım, birkaç semptomu tek bir belirsiz 'JavaScript bozuldu' cümlesine sıkıştırmak yerine gerçek kök nedeni bulmayı sağlar.

Kullanıcı deneyimi ve erişilebilirlik

Başarısız istekte ekranın sessiz kalması, teknik olarak küçük ama kullanıcı açısından ciddi bir hatadır. Yükleniyor durumu, zaman aşımı bildirimi, yeniden deneme seçeneği ve yalnızca başarılı yanıt sonrası güncellenen düğme metni net olmalıdır. Kullanıcının aynı formu tekrar göndermesini engellemek için geçici durum göstermek yardımcı olabilir; kalıcı çift kayıt önlemi ise sunucuda idempotent işlem tasarımıyla sağlanır. Hata açıklamalarını yalnızca renkle vermemek ve ekran okuyucunun algılayacağı bir durum bölgesi kullanmak bugün de geçerli ilkedir.

2012'den bugüne değişmeyen mühendislik refleksi

Fetch API, modern çerçeveler, izlenebilirlik altyapısı ve yapay zekâ destekli hata açıklamaları geldi. Buna rağmen işe yarayan araştırma döngüsü aynı: olayı gözlemle, hipotez kur, tek değişkeni test et, sonucu ölç ve yeniden doğrula. Bir asistan doğru görünümlü kod önerdi diye uygulamanın sorunu çözüldü kabul edilmez. Gerçek HTTP yanıtı ve veri durumu kontrol edilmelidir. Özellikle üretimde bir düzeltmenin önbellek, oturum ve bağlı veritabanı kayıtları üzerindeki etkisini birlikte değerlendirmek gerekir.

Kendin için pratik kontrol listesi

Bir AJAX problemiyle karşılaştığınızda şu sırayı uygulayın: isteği tekrar üretin; gerçek URL ve yöntemini yazın; durum kodunu ve yanıt tipini kaydedin; konsol ve ağ hatalarını ayırın; istemci/servis tarafını küçük deneyle izole edin; giriş/çerez yetkisini kontrol edin; sonra düzeltmeyi uygulayıp aynı hatayı yeniden test edin. Hata raporuna ekran görüntüsü yerine mümkünse güvenli biçimde maskelemiş istek kimliği ve beklenen/gerçekleşen sonucu da ekleyin. Böylece bugünün çözümü yarının ekip arkadaşına da fayda sağlar.

0 okunma

Yorumlar

0 gerçek yorum
KURGUSAL ÖRNEKDeniz · 2012 (temsili)

Eski AJAX sorunlarında önce Network sekmesinde yanıt gövdesini ve content-type başlığını kontrol ederdim. HTTP 200 her zaman beklediğimiz JSON anlamına gelmiyordu.

Temsili okuyucu görüşü ve tarih; gerçek yorum değildir.
✎ Yorum yaz

Yorumlar yayımlanmadan önce incelenir.