Web Geliştirme: HTML, CSS, JavaScript

Programlamaya Başlangıç JavaScript Fetch API ile Veri Çekme İşlemi

JavaScript Fetch API ile veri çekme işlemi, istemci tarafındaki web uygulamalarının sayfa yenilemeye ihtiyaç duymadan sunucudan dinamik olarak veri almasını ve sunucuya veri göndermesini sağlayan modern bir asenkron iletişim yöntemidir. Günümüz dinamik web sitelerinde hava durumu bilgilerinden kullanıcı profillerine, canlı borsa verilerinden alışveriş sepeti güncellemelerine kadar her türlü veri akışı Fetch API altyapısı kullanılarak gerçekleştirilir.

⚡ Kısa Cevap: Fetch API, JavaScript’te sunucu (backend) ile tarayıcı (frontend) arasında HTTP istekleri (GET, POST, PUT, DELETE) atmayı sağlayan dahili bir Promise tabanlı fonksiyondur. Eski XMLHttpRequest yapısına modern, okunabilir ve esnek bir alternatif olarak geliştirilmiştir.
🎯 Bu Derste Öğrenecekleriniz
  • Fetch API kavramını ve çalışma mantığını kavrayacaksınız.
  • Sunuculardan GET isteği ile JSON formatında veri çekmeyi öğreneceksiniz.
  • POST metodu kullanarak sunucuya nasıl veri gönderildiğini uygulayacaksınız.
  • Fetch işlemlerinde sık karşılaşılan hataları ve response.ok kontrolünü öğreneceksiniz.
  • Async/Await yapısıyla daha temiz ve okunabilir asenkron kod yazabileceksiniz.
📌 Konu Hakkında Kısa Bilgiler
  • Fetch API, tüm modern web tarayıcılarında dahili (built-in) olarak bulunur; ekstra kütüphane yükleme gerektirmez.
  • Veri transferi işlemlerini Promise yapısı üzerine kurduğu için asenkron çalışır ve tarayıcıyı kilitlediği hissedilmez.
  • Varsayılan olarak HTTP GET isteğinde bulunur.
  • Ağ hatalarında Promise reject olurken, 404 veya 500 gibi HTTP hata kodlarında Promise otomatik olarak çökmez.

JavaScript Fetch API Nedir ve Neden Kullanılır?

Web geliştirme dünyasında sunucu ile istemci arasındaki veri alışverişi geçmişte son derece karmaşık süreçlerden oluşuyordu. İptal edilen istekler, karmaşık callback fonksiyonları ve anlaşılması zor kod blokları tarayıcı deneyimini olumsuz etkiliyordu. Fetch API, modern JavaScript standartları (ES6) ile hayatımıza girerek bu süreci tamamen basitleştirmiştir.

Geleneksel web sitelerinde bir verinin güncellenmesi için tüm sayfanın yeniden yüklenmesi gerekirdi. Oysa Fetch API sayesinde yalnızca değişen veri kümesi arka planda çekilir ve sayfanın ilgili bölümü güncellenir. Bu duruma web mimarisinde Single Page Application (SPA) yapısı denir. Kullanıcı deneyimini kesintisiz hale getiren bu yaklaşım, web yazılımının temel yapı taşlarından biridir.

Fetch API’nin en büyük avantajı Promise tabanlı olmasıdır. Promise yapısı, bir işlemin gelecekte başarıyla tamamlanacağını veya bir hatayla sonuçlanacağını garanti eden nesnelerdir. Bu sayede kodlar zincirleme olarak (.then() ve .catch()) veya çok daha modern bir kullanım olan async/await blokları ile kolayca yönetilebilir.

Fetch API Temel Sözdizimi ve GET İsteği

Fetch API kullanırken en temel işlem bir sunucudan bilgi istemektir. Buna HTTP literatüründe GET isteği adı verilir. Fetch fonksiyonu parametre olarak veri çekilmek istenen URL adresini alır ve geriye bir Promise döner.

Aşağıdaki kod bloğunda, basit bir URL’den veri çekme işleminin en yalın hali gösterilmektedir. İlk aşamada sunucudan gelen yanıt ham bir HTTP yanıtı (Response object) halindedir. Bu yanıtın işlenebilir bir veriye dönüştürülmesi gerekir.

📖 Örnek: Temel GET İsteği

fetch('https://jsonplaceholder.typicode.com/posts/1')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Hata oluştu:', error));

Yukarıdaki örnek adım adım incelendiğinde; ilk satırda belirlenen adrese bir istek gönderilir. İlk .then() bloğu sunucudan yanıt geldiğinde çalışır ve gelen yanıtı JavaScript nesnesine çevirmek için response.json() metodunu çağırır. İkinci .then() bloğunda ise dönüştürülen veri kullanıma hazır hale gelir ve konsola yazdırılır.

💡 İpucu: fetch() fonksiyonu varsayılan olarak herhangi bir ikinci parametre verilmediğinde HTTP GET metodunu çalıştırır. Başka bir işlem türü belirtmek istemiyorsanız metot adını açıkça yazmanıza gerek yoktur.

Sunucudan Gelen JSON Verisini Anlamak ve İşlemek

Sunucular ve istemciler arasında veri alışverişi yapılırken en sık kullanılan standart format JSON (JavaScript Object Notation) formatıdır. JSON, insan tarafından kolay okunabilir ve makineler tarafından hızlıca ayrıştırılabilir hafif bir metin formatıdır.

Fetch API ile veri çekerken gelen yanıt bir metin akışıdır (stream). Bu akışı doğrudan bir JavaScript objesi gibi kullanamazsınız. response.json() metodu bu metin akışını okur ve arka planda ayrıştırarak bir JavaScript nesnesine veya dizisine dönüştürür. Bu dönüştürme işlemi de asenkron bir işlem olduğu için bir Promise döndürür.

Dönüştürülen veriler genellikle nesne dizileri (array of objects) şeklindedir. Örneğin bir kullanıcı listesi çektiğinizde, JavaScript üzerindeki forEach veya map gibi dizi metotlarını kullanarak bu verileri HTML elementlerine dönüştürebilir ve ekrana basabilirsiniz.

HTTP Metotları: POST İsteği ile Sunucuya Veri Gönderme

Fetch API yalnızca sunucudan veri almakla sınırlı değildir. Sunucuya yeni bir kayıt eklemek, mevcut bir veriyi güncellemek veya silmek için de kullanılır. Bu işlemlere HTTP istek metotları adı verilir.

Sunucuya yeni veri göndermek istediğimizde POST metodu kullanılır. POST isteği yapabilmek için fetch() fonksiyonunun ikinci parametresi olan ayar (options) nesnesini kullanmamız gerekir. Bu nesne içerisinde metodun türü, gönderilecek veri başlıkları (headers) ve ana gövde (body) yer alır.

📖 Örnek: POST İsteği Gönderme

const yeniVeri = {
  title: 'Yeni Başlık',
  body: 'İçerik detayı',
  userId: 1
};

fetch('https://jsonplaceholder.typicode.com/posts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(yeniVeri)
})
.then(response => response.json())
.then(data => console.log('Başarıyla eklendi:', data));

POST işleminde en kritik nokta JSON.stringify() kullanımıdır. JavaScript ortamında hazırladığımız nesneyi sunucunun anlayabileceği ham JSON dizesine dönüştürmemiz gerekir. Ayrıca headers kısmında gönderdiğimiz içeriğin bir JSON olduğunu 'Content-Type': 'application/json' ifadesiyle belirtmek zorundayız.

HTTP MetoduKullanım AmacıBody (Gövde) Gerekli mi?
GETSunucudan veri okumak ve çekmek.Hayır
POSTSunucuda yeni bir kaynak oluşturmak.Evet
PUTSunucudaki mevcut bir kaynağı tamamen güncellemek.Evet
DELETESunucudaki belirlenen kaynağı silmek.Genellikle Hayır

Fetch API ile Hata Yönetimi (Error Handling)

Yazılım geliştirmede ağ istekleri her zaman başarıyla sonuçlanmaz. İnternet bağlantısının kopması, sunucunun yanıt vermemesi veya yanlış URL istekleri gibi durumlarda hatalar meydana gelir. Fetch API kullanımında en çok yapılan hatalardan biri, HTTP hata kodlarının otomatik olarak yakalanacağını varsaymaktır.

Fetch API’de bulunan .catch() bloğu yalnızca fiziksel ağ hatalarında (örneğin kullanıcının internetinin kesilmesi veya alan adının bulunamaması durumunda) tetiklenir. Sunucu 404 (Sayfa Bulunamadı) veya 500 (Sunucu İç Hatası) kodu dönse bile Fetch bunu başarılı bir istek olarak görür.

⚠️ Dikkat: Fetch API, 404 veya 500 gibi HTTP hata kodlarında Promise’i reddetmez (reject etmez). Hatanın kontrolü geliştiricinin sorumluluğundadır. Bu kontrol response.ok özelliği kullanılarak yapılmalıdır.

Sunucudan dönen yanıtın gerçekten başarılı olup olmadığını kontrol etmek için response.ok mantıksal değerine bakılır. Eğer durum kodu 200-299 arasında ise response.ok değeri true, aksi halde false döner.

📖 Örnek: Doğru Hata Kontrolü Yapısı

fetch('https://jsonplaceholder.typicode.com/invalid-url')
  .then(response => {
    if (!response.ok) {
      throw new Error('HTTP hatası! Durum kodu: ' + response.status);
    }
    return response.json();
  })
  .then(data => console.log(data))
  .catch(error => console.error('Yakalanan Hata:', error.message));

Async / Await Yapısı ile Modern Fetch API Kullanımı

JavaScript ES8 ile hayatımıza giren async ve await anahtar kelimeleri, asenkron kod yazmayı senkron kod yazıyormuş gibi kolay ve anlaşılır hale getirir. Sürekli birbirine bağlanan .then() zincirleri yerine daha okunabilir yapı kurulmasını sağlar.

Bir fonksiyonun içerisinde await kullanabilmek için o fonksiyonun başında async yazılması gerekir. await ifadesi, arkasındaki Promise sonuçlanana kadar kodun yürütülmesini durdurur ve sonucu doğrudan bir değişkene atar.

📖 Örnek: Async/Await ve Try-Catch Kullanımı

async function verileriGetir() {
  try {
    const response = await fetch('https://jsonplaceholder.typicode.com/users');
    if (!response.ok) {
      throw new Error('Veri çekilemedi. Durum: ' + response.status);
    }
    const kullanicilar = await response.json();
    console.log(kullanicilar);
  } catch (error) {
    console.error('Bir hata oluştu:', error.message);
  }
}

verileriGetir();

Async/Await yaklaşımında hata yönetimi geleneksel try...catch blokları ile sağlanır. Kod okunabilirliği ciddi oranda artığı için günümüz modern yazılım projelerinde tercih edilen standart yaklaşım budur.

Gerçek Dünya Uygulaması: Sunucudan Veri Çekip Ekrana Yazdırma

Fetch API ile öğrenilen teorik bilgileri pratiğe dökmek için basit bir kullanıcı listesi uygulayalım. Bu uygulamada uzak bir REST API’den veri çekecek ve gelen veriyi HTML sayfasındaki bir listenin içerisine dinamik olarak aktaracağız.

İlk olarak HTML tarafında verilerin listeleneceği bir kapsayıcı eleman oluşturulur. Ardından JavaScript tarafında Fetch isteği atılarak gelen veriler dönülür ve DOM (Document Object Model) üzerinde manipülasyon gerçekleştirilir.

📖 Örnek: HTML ve JS Entegrasyonu

// HTML: <ul id="kullanici-listesi"></ul>

async function kullanicilariEkranaBas() {
  const listeElementi = document.getElementById('kullanici-listesi');
  try {
    const response = await fetch('https://jsonplaceholder.typicode.com/users');
    const kullanicilar = await response.json();

    kullanicilar.forEach(kullanici => {
      const li = document.createElement('li');
      li.textContent = `${kullanici.name} - ${kullanici.email}`;
      listeElementi.appendChild(li);
    });
  } catch (error) {
    listeElementi.innerHTML = '<li style="color:red;">Veriler yüklenirken bir hata oluştu.</li>';
  }
}

kullanicilariEkranaBas();

ℹ️ Bilgi: Büyük çaplı projelerde veri çekme işlemi sırasında kullanıcıya içeriğin yüklendiğini gösteren yükleniyor (loading) spinner’ları veya animasyonları göstermek kullanıcı deneyimini (UX) iyileştirir.
✏️ Kendinizi Test Edin
  1. Fetch API varsayılan olarak hangi HTTP metodunu kullanır?
  2. Sunucudan dönen yanıt 404 hatası verdiğinde Fetch API .catch() bloğuna düşer mi? Neden?
  3. Gelen yanıtı JavaScript nesnesine çevirmek için hangi yöntem çağrılır?
  4. POST isteği yaparken body alanına gönderilecek nesne hangi fonksiyon ile dönüştürülmelidir?
  5. Async/Await yapısında oluşan ağ hatalarını yakalamak için hangi blok yapısı kullanılır?
📝 Konu Özeti
  • Fetch API, tarayıcıda sunucularla asenkron iletişim kurmayı sağlayan modern bir arabirimdir.
  • Veri alma (GET), veri gönderme (POST), güncelleme (PUT) ve silme (DELETE) gibi tüm HTTP işlemlerini destekler.
  • İşlemler Promise tabanlı olduğu için asenkron yapıdadır.
  • Ağ hataları dışındaki HTTP hata kodları (404, 500 vb.) için response.ok kontrolü yapılmalıdır.
  • async/await ve try...catch yapısıyla birleştirildiğinde son derece temiz ve okunabilir kodlar yazılmasını sağlar.

Geliştirme Yolculuğunuzda Bir Sonraki Adım

JavaScript Fetch API mantığını kavramak, modern web geliştiricisi olma yolunda atılan en büyük adımlardan biridir. Bu teknoloji sayesinde artık sadece statik sayfalar değil, veritabanları ve dış servisler ile anlık haberleşen dinamik web uygulamaları geliştirebilirsiniz.

Öğrendiklerinizi pekiştirmek için ücretsiz erişim sunan açık REST API servislerini (örneğin hava durumu, döviz kurları veya film bilgisi sunan API’ler) kullanarak kendi küçük projelerinizi yapmaya başlayabilirsiniz. Bir sonraki aşamada ise gelişmiş istemci kütüphanelerini veya Axios gibi alternatif araçları inceleyerek bilgi dağarcığınızı genişletebilirsiniz.

Deniz Karay

DersMerkezi.net.tr’nin yazarı, eğitim alanında yıllara dayanan deneyime sahip bir uzmandır ve öğrencilerin öğrenme sürecini desteklemeyi hedefler. Matematik, fen bilimleri, tarih, dil ve edebiyat başta olmak üzere birçok ders alanında içerik üretir ve konuları sade, anlaşılır ve adım adım rehberler halinde sunar.

İlgili Makaleler

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Başa dön tuşu