Cypress Kurulumu ve İlk Testi Çalıştırma
Cypress, web uygulamalarında uçtan uca (End-to-End) test yazmak ve çalıştırmak için kullanılan popüler bir test aracıdır. Bu yazıda Cypress'in projeye kurulumu ve Test Runner'ın nasıl başlatılacağını adım adım anlatıyorum.
Cypress Kurulumu
İlk olarak Cypress'i projenin kurulu olduğu dizinde yüklüyorum. Cypress'in önerdiği kurulum yöntemi npm kullanmaktır.
npm install cypress --save-dev
Bu komut Cypress'i geliştirme bağımlılığı (devDependency) olarak projeye ekler.
Aynı zamanda farklı paket yöneticileri kullanıyorsanız aşağıdaki komutlarla da kurulum yapabilirsiniz.
yarn add cypress --dev pnpm add cypress --save-dev
Kurulum tamamlandıktan sonra Cypress proje içerisine eklenmiş olur.
Mevcut Projede Cypress Kurulumu
Eğer elimizde Cypress tanımlı hazır bir proje varsa ve sadece ilgili Cypress sürümünü kurmak istiyorsak aşağıdaki komutu çalıştırabiliriz.
./node_modules/.bin/cypress install
Bu komut projede tanımlı Cypress sürümünü indirir ve kurulumu tamamlar.
Cypress Test Runner'ı Başlatmak
Cypress'in arayüzünü (Test Runner) açmak için aşağıdaki komutu kullanıyorum.
npx cypress open
Bu komut Cypress Test Runner penceresini açar.
Eğer projedeki kurulu Cypress'i doğrudan çalıştırmak istersem aşağıdaki komutu da kullanabilirim.
./node_modules/.bin/cypress open
Her iki komut da aynı Test Runner ekranını açar.
Cypress Runner Ekranı
Komutu çalıştırdıktan sonra Cypress Test Runner açılır.
Bu ekranda önce kullanmak istediğimiz tarayıcıyı seçiyoruz. Tarayıcı seçildikten sonra Cypress ilgili tarayıcı ile test ortamını başlatıyor.
Test Spec Dosyalarını Çalıştırmak
Runner açıldıktan sonra proje içerisindeki tüm spec dosyaları listelenir.
Buradan çalıştırmak istediğimiz test dosyasına tıklamamız yeterlidir.
Herhangi bir spec dosyasına tıkladığımızda, o dosya içerisindeki testler sırasıyla çalışmaya başlar.
Test çalışırken Cypress aynı anda hem test adımlarını hem de tarayıcı üzerindeki işlemleri canlı olarak gösterir.
Kısaca Kurulum ve Başlatma Komutları
| İşlem | Komut |
|---|---|
| Cypress kurulumu (npm) | npm install cypress --save-dev |
| Cypress kurulumu (Yarn) | yarn add cypress --dev |
| Cypress kurulumu (pnpm) | pnpm add cypress --save-dev |
| Mevcut projede Cypress'i kur | ./node_modules/.bin/cypress install |
| Test Runner'ı aç | npx cypress open |
| Kurulu Cypress ile Runner'ı aç | ./node_modules/.bin/cypress open |
Sonuç
Cypress kurulduktan sonra Test Runner üzerinden tarayıcı seçebilir, proje içerisindeki spec dosyalarını görüntüleyebilir ve istediğiniz testi tek tıklamayla çalıştırabilirsiniz.
