Node.js 18 yerleşik fetch: Servis çağrısında zaman aşımı ve sonuç sözleşmesi
2022’de varsayılan olarak etkinleşen fetch ile HTTP durum kodlarını, bekleme üst sınırını ve servis sonuçlarını yönetme yaklaşımı.
2022 sürümünde ne değişti?
Node.js 18 duyurusunda global fetch API’si varsayılan olarak etkin, o sırada deneysel bir özellikti. Bir servis ekibi için bunun pratik etkisi, basit bir HTTP isteği için ayrı kütüphane ekleme gereğinin azalmasıydı. Bir tarayıcı API’sine benzer çağrı biçimi, sunucu tarafında hata ve zaman aşımı politikasının hazır olduğu anlamına gelmez. Örneğin bir ürün katalog servisinin kullanıcıya vereceği sonuç, uzak sunucunun 404 dönmesiyle hiç yanıt verememesini birbirinden ayırmalıdır. Basit çağrı aracının üstüne küçük bir hizmet sözleşmesi kurmak bu ayrımı görünür kılar.
HTTP sonucu ile ağ hatasını ayırmak
fetch, 404 veya 500 yanıtı geldi diye tek başına Promise’i reddetmez. Gelen Response üzerinden ok ve status alanlarını değerlendirmeniz gerekir. Örnek bir çağrıda 404 ürün yok anlamına gelebilir, 429 kapasite sınırı olabilir, 500 ise kaynak serviste hata olduğunu gösterir. Ağ hatası veya iptal başka bir yoldan ele alınır. Hata sınıflarını kontrol etmeden hepsini boş ürün listesine çevirmek kullanıcıyı yanıltabilir. Kayıtlarda durum kodu, bağımlı servis adı ve çağrı kimliği yararlıdır. Yanıt gövdesinin tamamını günlüğe eklemeyin.
Zaman aşımını çağıranla birlikte belirlemek
Bir bağımlı servis için ayrı bekleme sınırı seçin. AbortController ile uygulama tarafından yönetilen iptal sinyali kullanılabilir. Ana isteğin bütçesi de varsa başlangıçta harcanan süreyi hesaba katın. Bir istemci isteği iptal olduğunda aşağıya yapılan çağrıların gereksiz yere sürmemesi için sinyali destekleyen katmanlar arasında taşıyın. Yeniden deneme sürenin ve kapasitenin parçasıdır. Yalnız uygun işlem türlerinde, sınırlı sayıda ve artan beklemeyle yapın. Gövdeyi gönderen isteklerde sunucunun işlemi yapıp yanıtı kaybetmiş olabileceğini düşünün.
JSON ayrıştırma uygulama doğrulaması değildir
Uzak bir servis geçerli JSON döndürse de beklediğiniz nesne şemasına uymayabilir. Bir kimlik alanı beklenen sayı yerine metin, para birimi alanı da boş gelebilir. Gerekli alanları ve türlerini kontrol edin, isteğe bağlı alanları ayrı ele alın. Aşırı büyük yanıtları ve içerik türünü sisteminizin kapasitesine göre yönetin. Özellikle API değişikliklerinden sonra, başarı kodunun yanında gövde yapısını test etmek sahte başarıları azaltır. Bir katalog ekranı için eksik veriyle çalışmaya izin veriyorsanız bunun hangi kullanıcı davranışında güvenli olduğunu önceden belirleyin.
Uzak servisi beklemeden kendi testinizi kurun
Yerel bir HTTP test sunucusu ile 200, 404, 500, bozuk JSON ve kasıtlı gecikme senaryolarını üretin. Her testin çıktısı kullanıcıya uygun bir sonuç türü, izleme kaydı ve zaman aşımı beklentisi içersin. Gerçek bağımlı servise test trafiği göndermeden, çağrı sınırlarını tekrar tekrar deneyebilirsiniz. En önemli kontrol, hatalı veya gecikmiş servis çağrısı varken ana uygulamanın ne kadar süre kaynak tuttuğudur. Bu süreyi ölçüp servis bütçesine göre gözden geçirin. Açık geri dönüş kuralları, değişen Node sürümlerinde istemciyi karşılaştırmayı kolaylaştırır. Süre sınırını belgelemek için testlerde sabit saniyelerle beklemek yerine yerel sunucunun kontrollü gecikmesini kullanın. İstek iptal edilince bağlantı katmanının ve uygulama günlüğünün ne kaydettiğini ayrı kontrol edin. Bu sayede yalnızca negatif örneğin çalıştığını değil, tanı bilgisinin de operasyona ulaştığını doğrulayabilirsiniz.
Yorumlar
Henüz yorum yok. İlk katkıyı sen yapabilirsin.
Editörden tartışma sorusu Bir katalog servisi 429 döndüğünde sizin uygulamanız beklemeli mi, eski veriyi göstermeli mi?
“Node.js 18 yerleşik fetch: Servis çağrısında zaman aşımı ve sonuç sözleşmesi” başlıklı makalede özellikle şu noktayı düşündüm: küçük bir test uygulamasında performans karşılaştırması yapılabilir.
Editörün notu: Farklı ölçekteki sistemlerde sonuç değişebilir. Karşılaştırmada maliyet, gecikme ve kullanıcı deneyimini birlikte ele almak gerekir.
Burada bir de erişilebilirlik ve öğrenme eğrisi boyutu var. Kullanıcı açısından getirdiği kolaylık ölçülmeli.
Konu başlığını uygulamalı bir örnekle ele almak güzel olur. Yük testi veya pilot sonuçları karar vermeyi kolaylaştırır.
✎ Yorum yaz