JSON contract va pagination regression testi

~20 daq · Laravel · Katalogning JSON shartnomasi

Muammodan boshlaylik

Endpoint 200 qaytarsa ham client kutgan maydonlar yoki pagination buzilgan bo‘lishi mumkin.

Tushunib olamiz

Contract testi response strukturasi, qiymat turi va pagination chegarasini tekshiradi. Factory muhim qiymatlarni aniq beradi, random nomga assertion bog‘lanmaydi. JSON qidiruv validation ham 422 va errors key bilan tekshiriladi. Bu o‘qish API testi; auth, yozish, rate limit va permission testlari hali keyingi bosqich.

Ishlaydigan misol

Oldingi darsdagi kitoblar Laravel 13.x loyihasida ishlang. Misoldagi fayl yo‘li izoh yoki matnda ko‘rsatiladi; kodni alohida PHP script sifatida ishga tushirmang. Laravel serveri php artisan serve bilan 127.0.0.1:8000’da ishlasin. Har dars oldingi loyiha holatiga tayanadi.

// RefreshDatabase ishlatadigan KitobCrudTest klassiga qo‘shing:
public function test_json_catalog_contract(): void
{
    \App\Models\Kitob::factory()->count(11)->create([
        'nom' => 'PHP darsi', 'narx' => 50000,
    ]);
    $this->getJson(route('katalog.json', ['q' => 'PHP']))
        ->assertOk()
        ->assertJsonCount(10, 'data')
        ->assertJsonPath('data.0.nom', 'PHP darsi')
        ->assertJsonPath('data.0.narx', 50000)
        ->assertJsonPath('meta.total', 11)
        ->assertJsonStructure(['data' => [['id', 'nom', 'narx', 'muallif']],
                              'links', 'meta']);
    $this->getJson(route('katalog.json', ['q' => 'PHP', 'page' => 2]))
        ->assertOk()->assertJsonCount(1, 'data');
}
public function test_json_catalog_rejects_array_query(): void
{
    $this->getJson(route('katalog.json', ['q' => ['PHP']]))
        ->assertUnprocessable()->assertJsonValidationErrors('q');
}

Natija va izoh

Php artisan test --filter=KitobCrudTest bilan yangi va oldingi regression testlarni bajaring. Q array bo‘lsa SQLga yoki string concatenationga yetib bormasdan validationda to‘xtasin. Client JSONda HTML chiqmasligini ham tekshirishi mumkin.

[!WARNING] Testda fail bo‘lsa assertionni shunchaki olib tashlamang: route, query, resource yoki contractning qaysi qismi o‘zgarganini aniqlang. Baza ulanishi alohida test DSNda bo‘lsin.

Mustaqil mashq

Hech bir nomga mos kelmaydigan q uchun bo‘sh data va total 0 testini yozing.

Avval yechimni ochmasdan o‘zingiz yozing. Natijani oldindan taxmin qiling, so‘ng haqiqiy natija bilan solishtiring. Oddiy kirishdan tashqari bo‘sh qiymat, nol yoki mavjud bo‘lmagan element kabi chegara holatlarini ham tekshiring.

Yechim va tekshirish yo‘li

Testda aniq nomli kitob yarating, boshqa so‘z bilan getJson qiling, assertJsonCount(0, 'data') va meta.total 0ni kuting. Keyingi davom: DB identity/auth, policy, yuklash, token API, queue/cache va deploy.

Xulosa

Contract testi response strukturasi, qiymat turi va pagination chegarasini tekshiradi.

Misolni ko‘chirib ishlatish bilan cheklanmang: qiymatlarni almashtiring, bitta qoidani o‘zgartiring va qaysi holatda xato chiqishini kuzating. Yangi bilimni kursdagi kichik loyihangizga alohida qadam sifatida qo‘shing.

Keyingi qadam: kurs loyihasini mustaqil kengaytiring. Yangi talabni kichik bosqichga ajratib, xato holatlari bilan birga tekshiring. Keyingi chuqurlashtirilgan mavzularni rasmiy qo‘llanmadan o‘rganishda davom eting.

Rasmiy manba: Laravel 13.x rasmiy qo‘llanmasi