API Testlerinde Playwright ve AJV ile Şema Doğrulama

API Testlerinde Playwright ve AJV ile Şema Doğrulama

Merhaba! Fatih Soysal olarak, bugün sizlere API testlerinde Playwright ve AJV kütüphanelerini kullanarak şema doğrulamanın nasıl yapılacağını detaylı bir şekilde açıklayacağım. Bu güçlü kombinasyon, API yanıtlarınızın beklenen yapıya uygunluğunu doğrulamanızı sağlayarak testlerinizin güvenilirliğini önemli ölçüde artırır. Öncelikle, Playwright’in güçlü otomasyon yeteneklerini ve AJV’nin şema doğrulama becerisini kısaca inceleyelim. Ardından, bu iki kütüphaneyi birleştirerek pratik bir örnek üzerinde nasıl çalıştıklarını göstereceğim. Bu sayede, API testlerinizde daha sağlam ve güvenilir sonuçlar elde etmenizi sağlayacağım.

Playwright, çeşitli tarayıcıları destekleyen ve güçlü bir otomasyon çerçevesi sunan popüler bir araçtır. API testlerinde, HTTP isteklerini yönetmek ve yanıtları işlemek için ideal bir çözüm sunar. Diğer yandan, AJV (Another JSON Schema Validator), JSON şemalarını doğrulamak için kullanılan bir JavaScript kütüphanesidir. Bu, API yanıtlarınızın önceden tanımlanmış bir şema ile uyumlu olup olmadığını kontrol etmenizi sağlar. Bu iki teknolojinin birleşimi, API testlerinizin kapsamını ve güvenilirliğini önemli ölçüde geliştirir.

Playwright ve AJV Entegrasyonu

Playwright ile AJV entegrasyonu oldukça basittir. Öncelikle, projenize gerekli kütüphaneleri eklemeniz gerekmektedir. Bunun için, proje yönetim sisteminizde (örneğin npm veya yarn) aşağıdaki komutu çalıştırabilirsiniz:

npm install --save-dev playwright ajv

Kütüphaneleri kurduktan sonra, Playwright ile API isteği gönderip, AJV ile yanıtın şemasını doğrulayabilirsiniz. Aşağıda basit bir örnek verilmiştir:

const { chromium } = require('playwright');
const Ajv = require('ajv');

const ajv = new Ajv();

async function testAPI() {
  const browser = await chromium.launch();
  const page = await browser.newPage();

  const response = await page.request.fetch('https://api.example.com/data');
  const data = await response.json();

  const schema = {
    type: 'object',
    properties: {
      id: { type: 'integer' },
      name: { type: 'string' }
    },
    required: ['id', 'name']
  };

  const valid = ajv.validate(schema, data);

  if (valid) {
    console.log('Şema doğrulaması başarılı!');
  } else {
    console.error('Şema doğrulaması başarısız!', ajv.errors);
  }

  await browser.close();
}

testAPI();

Bu örnekte, https://api.example.com/data adresinden bir API isteği gönderilip, gelen yanıtın schema değişkeninde tanımlanan şema ile uyumlu olup olmadığı kontrol edilmektedir. ajv.validate fonksiyonu doğrulama işlemini yapar ve sonuç valid değişkenine atanır. Doğrulama başarısız olursa, hata mesajları ajv.errors değişkeninde bulunur.

Faydaları ve Sonuç

Playwright ve AJV’nin birleştirilmesiyle API testlerinizin kalitesi önemli ölçüde artar. Bu yaklaşım sayesinde, API yanıtlarının beklenen yapıya uygunluğunu otomatik olarak doğrulayabilirsiniz. Bu, hata tespitini kolaylaştırır ve test sürecinizi daha güvenilir hale getirir. Ayrıca, bu yöntem sayesinde testlerin sürdürülebilirliği de artar. Değişen API yapılarını kolayca takip edip testlerinizi güncelleyebilirsiniz. Daha fazla bilgi için fatihsoysal.com adresini ziyaret edebilirsiniz. Ayrıca, AJV kütüphanesi hakkında daha detaylı bilgi için https://ajv.js.org/ adresini inceleyebilirsiniz.

#Etiketler: API testi, Playwright, AJV, şema doğrulama, API otomasyonu, yazılım testi, kalite güvence, JSON Schema, API yanıt doğrulama, otomasyon testi