M

MLOG

O'zbek

Supertest yordamida API testlashga qaratilgan integratsion testlash bo'yicha to'liq qo'llanma, unda sozlash, eng yaxshi amaliyotlar va mustahkam ilovalarni sinash uchun ilg'or usullar yoritilgan.

Integratsion Testlash: Supertest yordamida API Testlashni O'zlashtirish

Dasturiy ta'minotni ishlab chiqish sohasida alohida komponentlarning izolyatsiyada to'g'ri ishlashini ta'minlash (moduliy testlash) juda muhim. Biroq, bu komponentlarning birgalikda uzluksiz ishlashini tekshirish ham xuddi shunday muhimdir. Aynan shu yerda integratsion testlash o'z o'rnini egallaydi. Integratsion testlash ilova ichidagi turli modullar yoki xizmatlar o'rtasidagi o'zaro ta'sirni tasdiqlashga qaratilgan. Ushbu maqolada integratsion testlash chuqur o'rganiladi, xususan, Node.js'dagi HTTP tasdiqlarini sinash uchun mo'ljallangan kuchli va qulay kutubxona bo'lgan Supertest yordamida API testlashga e'tibor qaratiladi.

Integratsion Testlash nima?

Integratsion testlash - bu alohida dasturiy modullarni birlashtirib, ularni guruh sifatida sinovdan o'tkazadigan dasturiy ta'minotni sinash turidir. Uning maqsadi birlashtirilgan birliklar o'rtasidagi o'zaro ta'sirlardagi nuqsonlarni aniqlashdir. Alohida komponentlarga e'tibor qaratadigan moduliy testlashdan farqli o'laroq, integratsion testlash modullar o'rtasidagi ma'lumotlar oqimi va boshqaruv oqimini tekshiradi. Keng tarqalgan integratsion testlash yondashuvlariga quyidagilar kiradi:

APIlar kontekstida integratsion testlash turli API'larning birgalikda to'g'ri ishlashini, ular o'rtasida uzatiladigan ma'lumotlarning izchilligini va umumiy tizimning kutilganidek ishlashini tekshirishni o'z ichiga oladi. Masalan, mahsulotlarni boshqarish, foydalanuvchi autentifikatsiyasi va to'lovlarni qayta ishlash uchun alohida API'larga ega bo'lgan elektron tijorat ilovasini tasavvur qiling. Integratsion testlash ushbu API'larning to'g'ri aloqa qilishini ta'minlab, foydalanuvchilarga mahsulotlarni ko'rib chiqish, xavfsiz tizimga kirish va xaridlarni yakunlash imkonini beradi.

Nima uchun API Integratsion Testlash muhim?

API integratsion testlash bir necha sabablarga ko'ra juda muhim:

Global sayohatlarni bron qilish platformasini ko'rib chiqing. API integratsion testlash turli mamlakatlardan kelgan parvozlarni bron qilish, mehmonxonalarni band qilish va to'lov shlyuzlarini boshqaradigan API'lar o'rtasida uzluksiz aloqani ta'minlash uchun juda muhimdir. Ushbu API'larni to'g'ri integratsiya qilmaslik noto'g'ri bron qilishlarga, to'lovlardagi nosozliklarga va yomon foydalanuvchi tajribasiga olib kelishi mumkin, bu esa platformaning obro'si va daromadiga salbiy ta'sir qiladi.

Supertest bilan tanishuv: API Testlash uchun kuchli vosita

Supertest - bu HTTP so'rovlarini sinash uchun yuqori darajadagi abstraktsiya. U ilovangizga so'rovlar yuborish va javoblarni tasdiqlash uchun qulay va ravon API taqdim etadi. Node.js ustiga qurilgan Supertest, ayniqsa Node.js HTTP serverlarini sinash uchun mo'ljallangan. U Jest va Mocha kabi mashhur testlash freymvorklari bilan a'lo darajada ishlaydi.

Supertest'ning asosiy xususiyatlari:

Testlash Muhitini Sozlash

Boshlashdan oldin, asosiy testlash muhitini sozlab olaylik. Sizda Node.js va npm (yoki yarn) o'rnatilgan deb taxmin qilamiz. Biz testlash freymvorki sifatida Jest'dan va API testlash uchun Supertest'dan foydalanamiz.

  1. Node.js loyihasini yarating:
mkdir api-testing-example
cd api-testing-example
npm init -y
  1. Bog'liqliklarni o'rnating:
npm install --save-dev jest supertest
npm install express  # Yoki API yaratish uchun siz afzal ko'rgan freymvork
  1. Jest'ni sozlang: package.json faylingizga quyidagilarni qo'shing:
{
  "scripts": {
    "test": "jest"
  }
}
  1. Oddiy API endpoint'ini yarating: Loyihangizda app.js (yoki shunga o'xshash) nomli fayl yarating va unga quyidagi kodni kiriting:
const express = require('express');
const app = express();
const port = 3000;

app.get('/hello', (req, res) => {
  res.send('Hello, World!');
});

app.listen(port, () => {
  console.log(`Example app listening at http://localhost:${port}`);
});

module.exports = app; // Testlash uchun eksport qilish

Birinchi Supertest Testini Yozish

Endi muhitimiz sozlangandan so'ng, API endpoint'imizni tekshirish uchun oddiy Supertest testini yozamiz. Loyihangizning ildiz papkasida app.test.js (yoki shunga o'xshash) nomli fayl yarating:

const request = require('supertest');
const app = require('./app');

descibe('GET /hello', () => {
  it('200 OK bilan javob beradi va "Hello, World!" matnini qaytaradi', async () => {
    const response = await request(app).get('/hello');
    expect(response.statusCode).toBe(200);
    expect(response.text).toBe('Hello, World!');
  });
});

Tushuntirish:

Testni ishga tushirish uchun terminalingizda quyidagi buyruqni bajaring:

npm test

Agar hamma narsa to'g'ri sozlangan bo'lsa, testning muvaffaqiyatli o'tganini ko'rishingiz kerak.

Supertest'ning Ilg'or Usullari

Supertest ilg'or API testlash uchun keng ko'lamli xususiyatlarni taklif etadi. Keling, ulardan ba'zilarini ko'rib chiqaylik.

1. So'rov tanasini yuborish

So'rov tanasida ma'lumotlar yuborish uchun .send() metodidan foydalanishingiz mumkin. Masalan, JSON ma'lumotlarini qabul qiladigan endpoint yarataylik:

app.post('/users', express.json(), (req, res) => {
  const { name, email } = req.body;
  // Ma'lumotlar bazasida foydalanuvchi yaratishni simulyatsiya qilish
  const user = { id: Date.now(), name, email };
  res.status(201).json(user);
});

Ushbu endpoint'ni Supertest yordamida quyidagicha sinab ko'rishingiz mumkin:

describe('POST /users', () => {
  it('yangi foydalanuvchi yaratadi', async () => {
    const userData = {
      name: 'John Doe',
      email: 'john.doe@example.com',
    };

    const response = await request(app)
      .post('/users')
      .send(userData)
      .expect(201);

    expect(response.body).toHaveProperty('id');
    expect(response.body.name).toBe(userData.name);
    expect(response.body.email).toBe(userData.email);
  });
});

Tushuntirish:

2. Sarlavhalarni o'rnatish

So'rovlaringizda maxsus sarlavhalarni o'rnatish uchun .set() metodidan foydalanishingiz mumkin. Bu autentifikatsiya tokenlarini, kontent turlarini yoki boshqa maxsus sarlavhalarni o'rnatish uchun foydalidir.

describe('GET /protected', () => {
  it('autentifikatsiyani talab qiladi', async () => {
    const response = await request(app).get('/protected').expect(401);
  });

  it('yaroqli token bilan 200 OK qaytaradi', async () => {
    // Yaroqli token olishni simulyatsiya qilish
    const token = 'valid-token';

    const response = await request(app)
      .get('/protected')
      .set('Authorization', `Bearer ${token}`)
      .expect(200);

    expect(response.text).toBe('Protected Resource');
  });
});

Tushuntirish:

3. Cookie'lar bilan ishlash

Supertest cookie'lar bilan ham ishlay oladi. Cookie'larni .set('Cookie', ...) metodi yordamida o'rnatishingiz mumkin yoki cookie'larga kirish va ularni o'zgartirish uchun .cookies xususiyatidan foydalanishingiz mumkin.

4. Fayl yuklashni testlash

Supertest fayl yuklashni boshqaradigan API endpoint'larini sinash uchun ishlatilishi mumkin. Fayllarni so'rovga biriktirish uchun .attach() metodidan foydalanishingiz mumkin.

5. Tasdiqlash kutubxonalaridan foydalanish (Chai)

Jest'ning o'rnatilgan tasdiqlash kutubxonasi ko'p hollarda yetarli bo'lsa-da, siz Supertest bilan Chai kabi kuchliroq tasdiqlash kutubxonalaridan ham foydalanishingiz mumkin. Chai yanada ifodali va moslashuvchan tasdiqlash sintaksisini taqdim etadi. Chai'dan foydalanish uchun uni o'rnatishingiz kerak bo'ladi:

npm install --save-dev chai

Keyin, Chai'ni test faylingizga import qilib, uning tasdiqlaridan foydalanishingiz mumkin:

const request = require('supertest');
const app = require('./app');
const chai = require('chai');
const expect = chai.expect;

describe('GET /hello', () => {
  it('200 OK bilan javob beradi va "Hello, World!" matnini qaytaradi', async () => {
    const response = await request(app).get('/hello');
    expect(response.statusCode).to.equal(200);
    expect(response.text).to.equal('Hello, World!');
  });
});

Eslatma: Chai bilan to'g'ri ishlash uchun Jest'ni sozlash kerak bo'lishi mumkin. Bu ko'pincha Chai'ni import qiladigan va uni Jest'ning global expect'i bilan ishlash uchun sozlaydigan sozlash faylini qo'shishni o'z ichiga oladi.

6. Agentlardan qayta foydalanish

Maxsus muhitni (masalan, autentifikatsiya) sozlashni talab qiladigan testlar uchun Supertest agentidan qayta foydalanish ko'pincha foydalidir. Bu har bir test holatida ortiqcha sozlash kodidan qochishga yordam beradi.

describe('Autentifikatsiyalangan API Testlari', () => {
  let agent;

  beforeAll(() => {
    agent = request.agent(app); // Doimiy agent yaratish
    // Autentifikatsiyani simulyatsiya qilish
    return agent
      .post('/login')
      .send({ username: 'testuser', password: 'password123' });
  });

  it('himoyalangan resursga kira oladi', async () => {
    const response = await agent.get('/protected').expect(200);
    expect(response.text).toBe('Protected Resource');
  });

  it('autentifikatsiyani talab qiladigan boshqa amallarni bajara oladi', async () => {
    // Boshqa autentifikatsiyalangan amallarni shu yerda bajaring
  });
});

Ushbu misolda biz beforeAll hook'ida Supertest agentini yaratamiz va agentni autentifikatsiya qilamiz. Keyinchalik describe bloki ichidagi testlar har bir test uchun qayta autentifikatsiya qilmasdan ushbu autentifikatsiyalangan agentdan qayta foydalanishi mumkin.

Supertest bilan API Integratsion Testlash uchun Eng Yaxshi Amaliyotlar

Samarali API integratsion testlashni ta'minlash uchun quyidagi eng yaxshi amaliyotlarni ko'rib chiqing:

Qochish kerak bo'lgan umumiy xatolar

Xulosa

API integratsion testlash dasturiy ta'minotni ishlab chiqish jarayonining muhim qismidir. Supertest yordamida siz ilovangizning sifati va barqarorligini ta'minlashga yordam beradigan keng qamrovli va ishonchli API integratsion testlarini osongina yozishingiz mumkin. Uchdan-uchgacha bo'lgan ish oqimlarini sinashga, realistik ma'lumotlardan foydalanishga, testlaringizni izolyatsiya qilishga va testlash jarayonini avtomatlashtirishga e'tibor qaratishni unutmang. Ushbu eng yaxshi amaliyotlarga rioya qilish orqali siz integratsiya muammolari xavfini sezilarli darajada kamaytirishingiz va yanada mustahkam va ishonchli mahsulot taqdim etishingiz mumkin.

API'lar zamonaviy ilovalar va mikroxizmatlar arxitekturalarini boshqarishda davom etar ekan, mustahkam API testlashning, ayniqsa integratsion testlashning ahamiyati faqat o'sib boradi. Supertest butun dunyodagi ishlab chiquvchilar uchun API o'zaro ta'sirlarining ishonchliligi va sifatini ta'minlash uchun kuchli va qulay vositalar to'plamini taqdim etadi.