Görsel regresyon testi Nexus StudioQA'da.
Nexus StudioQA'da görsel regresyon testi, her çalıştırmadan alınan ekran görüntüsünü onayladığınız bir referans görüntüyle karşılaştırır. --visual ile yapılan ilk çalıştırma referans görüntüyü oluşturur. Sonraki çalıştırmalar değişen pikselleri sayar, kenar yumuşatma uygulanmış kenarları yok sayar ve değişiklik toleransı aştığında bir fark görüntüsü saklar. Varsayılan olarak regresyon kaydedilir ancak testi başarısız kılmaz.
Nexus StudioQA ekibi tarafından, Verdict System LLC.
Son güncelleme: .
Her çalıştırmada neler karşılaştırılır
Her biri kendi toleransına sahip iki kontrol noktası türü: tolerans, değişikliğin regresyon sayılmasından önce farklı olmasına izin verilen piksellerin oranıdır.
| Kontrol noktası | Görüntüsü alınan alan | Varsayılan tolerans |
|---|---|---|
| Tüm sayfa | Test sonunda görünüm alanının alınan ve baseline adıyla kaydedilen ekran görüntüsü. | Piksellerin %1.0'ı (NEXUS_VISUAL_THRESHOLD) |
| Öğe | Test içinde visualCheck(page, 'cart-total', page.locator('#cart-total')) ile belirlenen tek bir öğe. | Piksellerin %0.1'i (NEXUS_VISUAL_ELEMENT_THRESHOLD) |
Değişikliğe nasıl karar verilir
Referans görüntüler tarayıcı ve platform bazında saklanır
Proje klasöründeki
visual-baselines/<browser>@<platform>/dizininde bulunurlar, böylece kodunuzla birlikte sürüm kontrolüne alınabilirler. Yazı tipleri ve kenar yumuşatma farklı olduğundan, bir Windows görüntüsü asla bir Linux görüntüsüyle karşılaştırılmaz. Referans görüntüsü olmayan bir tarayıcı ve platform kendi referansını oluşturur.Kenar yumuşatma uygulanmış kenarlar sayılmaz
Yalnızca bir kenarın renkleri yeniden harmanlandığı için değişen piksel, fark görüntüsünde kehribar rengiyle gösterilir ve sayıma dahil edilmez. Bir renk kanalında 10 veya daha fazla fark olduğunda piksel değişmiş sayılır ve NEXUS_VISUAL_PIXEL_TOLERANCE bu değeri 0 ile 255 arasında değiştirir.
Görüntüler sabitlenene kadar yeniden alınır
Art arda iki görüntü bayt düzeyinde aynı olana kadar, en fazla üç kez görüntü alınır. Hiç sabitlenmeyen bir sayfa, fark edilmeden referans haline gelmek yerine kararsız olarak raporlanır.
Farklı boyuttaki görüntü esnetilmez
İki görüntü, sol üst köşeye hizalanarak ortak bölgeleri üzerinden özgün boyutlarında karşılaştırılır. Örtüşmeyen alanlar farklı sayılır.
Çalıştırılmayan bir kontrol başarısız sayılır
Karşılaştırma çalıştırılamazsa, örneğin bir görüntü eksikse veya yerel görüntü kitaplığı yüklü değilse, katı mod ayarı ne olursa olsun test başarısız olur. Hiç yapılmamış bir kontrol başarılı olarak raporlanmaz.
Önemli ayarlar
Her biri Studio'nun Görsel Regresyon ekranında yer alır ve varsayılan değerleri aşağıda verilmiştir.
| Ayar | Varsayılan | Ne yapar |
|---|---|---|
| Her çalıştırmada pikselleri karşılaştır | Kapalı | Her çalıştırma için karşılaştırmayı etkinleştirir. --visual ise tek bir çalıştırma için etkinleştirir. |
| Regresyon testi başarısız kılar | Kapalı | NEXUS_VISUAL_STRICT=true olduğunda, toleransı aşan piksel değişiklikleri testi başarısız kılar. Kapalı olduğunda regresyon kaydedilir ve testin sonucu değişmez. |
| Her fotoğrafta maskelenenler | Yok | Saat veya reklam gibi, her fotoğrafta üzeri boyanan öğelerin CSS seçicileri (NEXUS_VISUAL_MASK). |
| Saklanan regresyon klasörleri | 10 | Her test ve kontrol noktası için saklanan en yeni klasörler (NEXUS_VISUAL_REGRESSION_RETAIN). |
İncelediğiniz ve onayladığınız içerikler
Her regresyon kendi dosyalarıyla birlikte visual-regression altında saklanır ve Studio bunları aynı kontrol noktasının önceki çalıştırmalarının yanında dört görünümde gösterir: Yan yana, Kaydırma, Fark ve Yanıp sönme.
| Dosya | Nedir |
|---|---|
baseline.png | Onaylanan görüntü. |
current.png | Bu çalıştırma’nın görüntüsü. |
diff.png | Değişen pikseller için kırmızı, yok sayılan kenar yumuşatma için kehribar, değişmeyenler için gri. |
visual-report.md | Düz metin olarak sayısal değerler. |
result.json | Veri biçiminde aynı sonuç. |
Size söyleyemeyecekleri
Pikseller planlı bir yeniden tasarımı bir hatadan ayıramaz, bu nedenle her değişikliği bir kişi onaylar: Studio'daki Bu değişikliği onayla seçeneği bir kontrol noktası’nın görüntüsünü değiştirir ve nexus baseline --update <TC_ID> komutu da aynı işlemi komut satırından yapar. Saat, reklam veya avatar gibi kendiliğinden değişen her şey maskelenmelidir, aksi takdirde karşılaştırmayı sürekli kırmızıya çevirir.
Sık sorulan sorular
Görsel regresyon testimi başarısız kılar mı?
Varsayılan olarak hayır. Regresyon kaydedilir ve testin sonucu değişmez.
NEXUS_VISUAL_STRICTayarını etkinleştirirseniz toleransı aşan bir regresyon testi başarısız kılar.Neden her işletim sistemi için ayrı bir referans görüntü var?
Aynı sayfa Windows, Linux ve macOS üzerinde biraz farklı yazı tipleri, kenar yumuşatma ve kaydırma çubuklarıyla görüntülenir. Bunlar arasında karşılaştırma yapmak, yalnızca görüntüleme motorundan kaynaklanan bir farkı değişiklik olarak raporlar, bu nedenle her tarayıcı ve platform kendi referans görüntüsünü saklar.
Bir saatin veya reklamın kontrolü başarısız kılmasını nasıl önlerim?
Görsel ayarlarda bir CSS seçicisiyle maskeleyin veya sayfanın ilgilendiğiniz bölümünde bir öğe kontrol noktası kullanın. Bir öğe kontrol noktasına tüm sayfa toleransının onda biri uygulanır, böylece hareketli bir reklam sonucu kırmızıya çevirmeden sıkı bir kontrol sağlanır.
Referans görüntüler nerede saklanır?
Kanıt klasöründe değil, proje klasörünüzdeki
visual-baselinesiçinde saklanırlar, böylece kodla birlikte sürüm kontrolüne eklenebilirler. Regresyon farkları çalıştırma çıktılarıdır ve kanıt klasörünün altındakivisual-regressioniçinde yer alır.
Kendi makinenizde çalıştırın.
Tüm özellikleri kendi makinelerinizde ücretsiz deneyin. Kart gerekmez.