Modul 0: Kurs xəritəsi və quraşdırma

Xoş gəldiniz! Bu modul kursun başlanğıc nöqtəsidir. Heç bir əvvəlki Playwright təcrübəsi olmadan, bu modulun sonunda işləyən bir test yazacaq və onu öz kompüterinizdə işlədəcəksiniz.

🎬 Video tezliklə əlavə olunacaq

Playwright nədir və niyə vacibdir

Playwright — Microsoft tərəfindən hazırlanmış açıq mənbəli brauzər avtomatlaşdırma freymvorkudur. Chromium, Firefox və WebKit (Safari) brauzerlərini dəstəkləyir, yəni bir test bütün əsas brauzerlərdə işləyə bilər.

Niyə Playwright seçilir?

Sürətlidir — testlər paralel işləyir
Etibarlıdır — avtomatik gözləmə sayəsində sleep() yazmazsınız
Güclüdür — API testi, şəbəkə müdaxiləsi, auth vəziyyəti, mobil emulasiya — hamısı daxildir
Azərbaycan dilində resurslar var — BrauzerLab məhz bunun üçün yaradılıb

Kurs boyu nə quracağıq

Bu kurs boyu real, işlənən bir avtomatlaşdırma layihəsi quracağıq. Hər modul bir yeni qat əlavə edir:

Modul 0–3: Əsaslar — quraşdırma, lokatorlar, əməliyyatlar
Modul 4–6: Keyfiyyət — iddialar, flaky test qarşısının alınması, konfiqurasiya
Modul 7–10: Miqyas — POM, fixtures, API, auth
Modul 11–13: Peşəkar səviyyə — vizual test, CI, yekun layihə

Manual QA-dan avtomatlaşdırmaya keçid (düşüncə tərzi)

Manual QA-da siz hər addımı özünüz əllə icra edirsiniz: “Bu düyməyə basıram, bu mətn görünür, bu URL dəyişir.” Avtomatlaşdırmada isə həmin addımları kod şəklində yazırsınız.

Əsas fərq: Manual test bir dəfədir. Avtomatik test yüzlərlə dəfə, saniyələr içində, heç bir insan müdaxiləsi olmadan işləyə bilər.

Keçid zamanı yadda saxlayın:

Kod yazmaq öyrənilir — siz artıq test düşüncə tərzinə sahibsiniz
Kod xətaları normaldır — hər kəsin kodu ilk dəfə işləmir
Playwright API-si oxunaqlıdır — page.click('Login') nə edəcəyini açıq göstərir

Node, VS Code və Git-in quraşdırılması

Bu üç aləti quraşdıracağıq. Hər addım modulun videosunda da göstərilir — addımın yanındakı vaxt nişanına klikləyərək birbaşa həmin hissəyə keçə bilərsiniz.

Node.js — LTS versiyası. nodejs.org saytına keçin və LTS versiyasını yükləyin (Current yox). Quraşdırıcıda bütün addımlarda standart seçimləri saxlayın. Sonra terminalda yoxlayın:
Terminal window
```
node --version   # v20.x.x və ya daha yüksək
npm --version    # v10.x.x və ya daha yüksək
```
🎬 Videoda: tezliklə əlavə olunacaq
Node.js quraşdırma — slayd təlimatı Slaydlar — yeni pəncərədə açılır
VS Code. code.visualstudio.com saytından Stable versiyasını yükləyin. Quraşdırdıqdan sonra bu əlavələri qurun: Playwright Test for VSCode (testləri redaktordan birbaşa işlətmək üçün) və ESLint (kod keyfiyyəti üçün).

🎬 Videoda: tezliklə əlavə olunacaq
VS Code quraşdırma — slayd təlimatı Slaydlar — yeni pəncərədə açılır
Git. git-scm.com saytından yükləyin və quraşdırmada standart seçimləri qəbul edin. Sonra yoxlayın:
Terminal window
```
git --version
```
🎬 Videoda: tezliklə əlavə olunacaq
Git quraşdırma — slayd təlimatı Slaydlar — yeni pəncərədə açılır

Brauzerlərə gəlincə: Playwright onları özü ayrıca quraşdırır (növbəti addımda) — sistem brauzerləri ilə qarışdırmayın.

Playwright-in quraşdırılması

Yeni bir qovluq yaradın və Playwright-i quraşdırın:

mkdir playwright-kurs
cd playwright-kurs
npm init playwright@latest

Quraşdırma zamanı bu suallar çıxacaq:

TypeScript or JavaScript? — TypeScript seçin (kurs boyu TypeScript istifadə edirik)
tests folder name? — tests daxil edin (standart)
GitHub Actions workflow? — hələlik false
Install Playwright browsers? — true (mütləq lazımdır)

Brauzerlərin yüklənməsi bir neçə dəqiqə çəkə bilər — bu normaldır.

İlk Playwright layihəsinin yaradılması

Quraşdırma tamamlandıqdan sonra layihə strukturuna baxaq:

ls

Aşağıdakı faylları görmüş olacaqsınız:

playwright-kurs/
├── tests/
│   └── example.spec.ts
├── playwright.config.ts
├── package.json
└── node_modules/

`package.json`, `tests/` və `playwright.config.ts` strukturu

`package.json`

Layihənizin “identifikasiya kartı”dır. Asılılıqları, skriptləri və metadata-nı saxlayır. Playwright skripti belə görünür:

{
  "scripts": {
    "test": "playwright test"
  }
}

`tests/` qovluğu

Bütün .spec.ts fayllarınız burada yaşayır. Playwright bu qovluqdakı bütün test fayllarını avtomatik tapır.

`playwright.config.ts`

Playwright-in əsas konfiqurasiya faylıdır. Buradan:

Hansı brauzerlər işlədilsin
Bütün testlər üçün baseURL nə olsun
Testlər paralel işləsinmi
Uğursuz testlər yenidən cəhd etsinmi

kimi parametrləri tənzimləyirsiniz.

İlk testin işə salınması

Playwright-in hazır nümunə testini işlədin:

npx playwright test

Konsolda belə bir çıxış görməlisiniz:

Running 6 tests using 6 workers
  6 passed (8s)

Uğurla keçdi! Playwright üç brauzerdə (chromium, firefox, webkit) iki test ssenarisini işlətdi.

HTML hesabatının açılması

Playwright test nəticələrini gözəl bir HTML hesabatında göstərə bilər:

npx playwright show-report

Bu əmr brauzeri açır və hər testin:

Keçdi/uğursuz oldu statusunu
İcra müddətini
Skrinşotlar və izlərini (uğursuzluq zamanı)

göstərir. CI mühitlərində bu hesabat artifakt kimi saxlanılır.