İçeriğe geç

Geliştiriciler için bug raporlama: kendin toplayacağın kanıtlar, hazır

Güncelleme

Geliştiriciler için bug raporlama, rapor senin kendin toplayacağın şeyleri içerdiğinde en iyi sonucu verir: stack trace'iyle konsol hatası, body'siyle başarısız istek, oraya götüren adımlar ve sorunun yaşandığı tarayıcı. Midge bunların hepsini bir Chrome sekmesinden otomatik olarak yakalar, videoyla tek bir zaman çizelgesinde hizalar ve gizli bilgileri yüklemeden önce maskeler; böylece rapor bir ticket'a, bir pull request'e ya da bir yapay zekâ sohbetine güvenle yapıştırılabilir.

Her kayıtta konsol logları, ağ istekleri, kullanıcı adımları ve cihaz bilgileri var. Bu da daha az "konsolu gönderebilir misin?" mesajı ve ilk okumada düzeltilen daha fazla bug demek.

Bir raporda neler var

Tek zaman çizelgesi

Video; konsol mesajları, ağ istekleri ve kullanıcı adımlarından oluşan, zamana göre sıralanmış bir panelin yanında durur. Save'e tıklamayı izlersin; ardından gelen PATCH /api/projects/88 hemen oradadır, yanıt geldikten birkaç milisaniye sonraki Uncaught TypeError da öyle. Sırayı üç ayrı ekten yeniden kurmak zorunda kalmazsın.

Stack trace'li konsol

debug'dan error'a kadar tüm seviyeler, ayrıca stack'leriyle yakalanmamış istisnalar ve işlenmemiş promise reddedilmeleri. Midge sayfa yüklenirken dinlemeye başlar, böylece açılış hataları da dahil olur; sürekli yenilenen bir tampon da tuttuğu için testçi kayda basmadan önceki hatalar da oradadır. Ayrıntılar konsol logları sayfasında.

Ağ ayrıntıları

Fetch ve XHR istekleri header'ları, istek ve yanıt body'leri, durum kodları ve süreleriyle gelir. WebSocket mesajları iki yönde de kaydedilir. Diğer kaynaklar durum, boyut ve süreyi gösterir. GraphQL'de her istek operation adını gösterir; bir errors dizisi taşıyan 200 yanıtları da işaretlenir, çünkü bir durum filtresi onları kaçırırdı. Daha fazlası ağ logları sayfasında.

Cihaz bilgileri

Tarayıcı ve sürümü, işletim sistemi, pencere boyutu, dil, saat dilimi ve URL. Aynı ortamı kurmaya ya da bug'ın yalnızca Almanca yerel ayarda olduğunu fark etmeye yeter.

cURL olarak kopyala

Her istek bir cURL komutu olarak kopyalanıp terminalinden çalıştırılabilir:

curl 'https://staging.acme.dev/api/projects/88' \
  -X PATCH \
  -H 'Content-Type: application/json' \
  -H 'Authorization: [REDACTED]' \
  --data-raw '{"name":"Q4 roadmap","archived":null}'

Maskelenmiş Authorization header'ı bilerek böyle. Kendi test kullanıcının token'ını koy; kimse canlı bir oturumu paylaşmadan tam olarak aynı isteği yeniden üretirsin. Kendi ortamından bir token'ı incelemek istersen ücretsiz JWT çözücü onu hiçbir yere göndermeden claim'lerini ve son kullanma zamanını gösterir.

Maskelenmiş bir HAR indir

Bir performans sorusu ya da bir API sağlayıcısının destek ekibi için ağ logunun tamamına ihtiyacın olduğunda onu HAR dosyası olarak indir. Dosya maskelenmiş veriyi içerir. Ücretsiz HAR görüntüleyicide ya da HAR okuyan herhangi bir araçta aç. Birinin doğrudan DevTools'tan dışa aktardığı bir HAR ile çalışıyorsan, onu iletmeden önce HAR dosyasından hassas veriler nasıl silinir rehberini oku.

Raporlar güvenle yapıştırılsın diye maskeleme

Bug raporları her yere yapıştırılır: ticket'lar, Slack thread'leri, pull request açıklamaları, kodlama asistanlarıyla sohbetler. Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce tarayıcında maskelenir. Bunlara şunlar dahil:

  • Authorization, Cookie ve Set-Cookie header'ları ve adında token, secret, session ya da auth geçen her header,
  • access_token, code ve signature gibi hassas URL parametreleri,
  • password, otp, cvv ve client_secret gibi body alanları,
  • JWT'ler, Luhn kontrolünden geçen kart numaraları, özel anahtarlar ve Stripe, AWS, GitHub, Slack, Google, OpenAI ile Anthropic API anahtarları.

İstek kimlikleri ve rastgele görünen diğer değerler bilerek tutulur, çünkü eşleşen sunucu loglarını bulmak için onlara ihtiyacın var. Maskeleme kurallara dayalı; uygulamanın kendine özgü gizli alanları varsa onları çalışma alanının listesine ekle. Kuralların tamamı maskeleme sayfasında.

Kodlama ajanlarıyla çalışmak

Midge'in https://midge.dev/mcp adresinde bir MCP sunucusu var; böylece Claude Code, Cursor ve diğer ajanlar bir raporun konsolunu, ağını ve adımlarını doğrudan okuyabilir. Rapor bağlantısını sohbete yapıştır; ajan ihtiyacı olanı get_console, get_network ve get_user_actions gibi salt okunur araçlarla çeker. Tarayıcın üzerinden giriş yapar ya da Settings › Account › AI assistants'tan alınan bir token kullanır. Başarısız isteği yine cURL olarak kopyalayabilir ya da maskelenmiş HAR'ı ekleyebilirsin. Her iki durumda da veri zaten temizlenmiş olur.

Ekibinden daha iyi raporlar almak

En iyi araç bile insanların neyi yakaladığına bağlı. Bug raporu nasıl yazılır rehberimizi testçilerle ve destek ekibiyle paylaş, onları ekran kaydediciye yönlendir. Midge ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok; yani kimsenin kayıtları idareli kullanması gerekmez.

Sık sorulan sorular

Bir geliştirici Midge raporunu açtığında ne görür?
Video ya da ekran görüntüsünü, yanında da zamana göre sıralanmış konsol mesajları, ağ istekleri, kullanıcı adımları ve cihaz bilgilerini. İstekler header'ları, body'leri, durum kodlarını ve süreleri gösterir.
Başarısız bir isteği yeniden çalıştırabilir miyim?
Evet. Yakalanan her istek bir cURL komutu olarak kopyalanabilir. Kimlik doğrulama header'ları ve çerezler maskelenir; bu yüzden çalıştırmadan önce kendi test hesabının token'ını eklersin.
Bir Midge raporunu herkese açık bir issue'ya ya da bir yapay zekâ sohbetine yapıştırmak güvenli mi?
Midge şifreleri, kart numaralarını, token'ları, çerezleri ve bilinen API anahtarı formatlarını yüklemeden önce siler. Maskeleme kurallara dayalı, yani alışılmadık şeyleri gözden geçir; ama yaygın gizli bilgiler zaten gitmiş olur.
Midge'i kendi hata ayıklamam için kullanabilir miyim?
Evet. Kendi bulduğun bir bug'ı kaydetmek, onu bir ekip arkadaşına devretmenin ya da logları eksiksiz şekilde ona sonra geri dönmenin hızlı bir yolu.