Logları da yanında tutan bir ekran görüntüsü Chrome eklentisi
Güncelleme
Midge, bug raporları için yapılmış bir ekran görüntüsü Chrome eklentisi. Bir sekmenin görünen kısmını ya da seçtiğin bir bölgeyi yakalar, üzerine ok, kutu, kalem, metin ve bulanıklık eklersin ve tek bir bağlantıyla paylaşırsın. Sıradan bir ekran görüntüsü aracından farklı olarak Midge, sayfanın son konsol loglarını, ağ isteklerini, kullanıcı adımlarını ve cihaz bilgilerini ekler; böylece görsel, bir geliştiricinin ihtiyaç duyduğu kanıtlarla birlikte gelir.
Midge ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok. Ekran görüntüleri de kayıt sayılır; yani istediğin kadar alıp paylaşabilirsin.
Yakalamanın iki yolu
Görünen alan
Tek tıkla sekmede gördüğün şeyi yakalarsın; tarayıcı araç çubuğu, yer imleri çubuğu ya da diğer pencereler girmez. Sayfa düzeninin tamamı önemliyse bunu kullan: yanlış temayla açılan bir sayfa, bozuk bir grid, görünmemesi gerekirken ortaya çıkan bir boş durum ekranı.
Seçili bölge
Yanlış olan kısmın etrafına bir dikdörtgen çiz. Kaymış bir düğmenin ya da kesilmiş bir etiketin sıkı kırpılmış hali, okuyanın sorunu aramak zorunda kaldığı tam sayfadan çok daha kolay okunur. Hangi sayfada olduğun ve neye tıkladığın gibi bağlamı yine açıklamaya ekleyebilirsin.
Sorunu apaçık gösteren notlar
Yakalamadan sonra Midge basit bir düzenleyici açar:
- Ok: Tam olarak o öğeyi göster. “Bu, yanındaki değil.”
- Kutu: Bir alanı çerçevele; örneğin aynı olması gereken iki fiyatı.
- Kalem: Bir şeyi serbest çizimle daire içine al ya da altını çiz.
- Metin: Görselin üzerine “3 ürün yazmalı” gibi kısa bir etiket ekle.
- Bulanıklık: Paylaşmadan önce bir müşteri adını, bir e-posta adresini ya da bir hesap numarasını gizle.
Notları az ve net tut. Tek bir ok ve üç kelimelik bir etiket, genellikle üst üste binen beş kutudan daha iyidir.
Loglar ekran görüntüsüyle birlikte gelir
Sıradan bir ekran görüntüsü aracının yapamadığı kısım bu. Midge arka planda sayfanın konsol ve ağ etkinliğini dinler ve son birkaç dakikayı bellekte tutar. Ekran görüntüsü aldığında bu bağlam eklenir. Her kayıtta konsol logları, ağ istekleri, kullanıcı adımları ve cihaz bilgileri var. Ekran görüntüsü raporu da aynı verileri taşır.
Bunun neden önemli olduğunu bir örnekle görelim. Bir dashboard kartının dönüşüm oranı yerine “NaN%” gösterdiğini düşün. Ekran görüntüsü belirtiyi gösterir. Ekli ağ logu ise nedeni:
GET /api/metrics/conversion 200
{"visits": 0, "orders": 0, "rate": null}
Geliştirici, API'nin sıfır ziyaretli bir gün için null döndürdüğünü ve front end'in sıfıra böldüğünü görür. Bu, bir günlük gidip gelme yerine beş dakikalık bir düzeltme demek. Ayrıntılar için ağ logları ve konsol logları sayfalarına bak.
Arka plandaki yakalama cihazında kalır. Bellekte yaşar, sekmeyi kapattığında temizlenir ve yalnızca bir rapor oluşturduğunda bilgisayarından çıkar. Bankan gibi Midge'in hiç çalışmaması gereken siteleri de listeleyebilirsin.
Ekran görüntülerinde gizlilik
Düşünmen gereken iki katman var.
Görsel. Ekranda gördüğün şey ekran görüntüsüne girer. Paylaşmadan önce kişisel verilere bulanıklaştırma aracını uygula. Şifre ve kart alanlarının otomatik bulanıklaştırılması ekran görüntülerinde değil, sekme kayıtlarında geçerli; yani burada bulanıklaştırma senin işin.
Loglar. Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce tarayıcında maskelenir. E-postalar yarı maskelenir; böylece geliştirici bug'a hangi test hesabının denk geldiğini yine de anlayabilir. Kuralların tam listesi maskeleme sayfasında.
Ekran görüntüsü mü, video mu?
Bug tek bir karede görünüyorsa ekran görüntüsü kullan: yanlış metin, bozuk düzen, yanlış bir sayı, eksik bir ikon. Bug bir adım sırasına, zamanlamaya ya da animasyona bağlıysa, örneğin tıklayamadan kapanan bir menü ya da iki kez gönderilen bir form, ekran kaydı kullan. Hazır değilken tuhaf bir şey olduysa ve o site için açtıysan, anlık tekrar son birkaç düzine saniyeyi kaydedebilir.
Paylaşma
Her ekran görüntüsünün bir bağlantısı olur. Kimin açabileceğine sen karar verirsin: bağlantıya sahip herkes, çalışma alanının üyeleri ya da yalnızca sen. Ekibinin sonradan bulabilmesi için onu bir klasöre koy; örneğin her sürüm ya da her sprint için bir klasör. Ekipler ve klasörler ücretsiz.
İyi bir ekran görüntüsü bug raporu
Ekran görüntüsü “ne yanlış” sorusunu yanıtlar. Açıklama ise “ne bekliyordun” ve “oraya nasıl gelirim” sorularını yanıtlamalı. Kısa bir örnek:
Title: Order count shows 0 on the Orders tab after filtering by "Last 7 days"
Steps: Orders, set filter to Last 7 days, wait for the list to load
Expected: count matches the 12 rows in the list
Actual: count shows 0 (arrow in screenshot)
Bug raporu şablonumuzda ve bug raporu örneklerimizde buna benzer başka kalıplar da var. Bir ekip arkadaşın bir istekten aldığı token'ı gönderdiyse ve içinde ne olduğunu görmek istiyorsan, ücretsiz JWT çözücü onu hiçbir yere göndermeden tarayıcında okur.
Sık sorulan sorular
- Sayfanın yalnızca bir kısmını yakalayabilir miyim?
- Evet. Sekmenin görünen alanını yakalayabilir ya da sürükleyerek bir bölge seçebilirsin. Yalnızca bozuk bileşeni seçmek, ekran görüntüsünü okunaklı tutar.
- Hangi not araçları var?
- Ok, kutu, serbest çizim kalemi, metin etiketleri ve bulanıklaştırma aracı. İsimler, e-postalar ya da görselde olmasını istemediğin her şey için bulanıklaştırmayı kullan.
- Ekran görüntüsünde konsol ve ağ logları da var mı?
- Evet. Midge sen gezinirken son konsol ve ağ etkinliğini bellekte tutar; böylece bir hatadan sonra aldığın ekran görüntüsü, hatadan önceki logları da taşır.
- Şifre alanları ekran görüntülerinde otomatik gizleniyor mu?
- Şifre ve kart alanlarının otomatik bulanıklaştırılması sekme kayıtlarında geçerli. Ekran görüntüsünde, paylaşmadan önce hassas olan her şeye bulanıklaştırma aracını uygula. Loglardaki token ve çerez gibi gizli bilgiler her iki durumda da maskelenir.