İyi bir tarayıcı hatası bildirme

Tarayıcı tedarikçi firmalarına, tarayıcılarında karşılaştığınız sorunları bildirme web platformunu daha iyi hale getirmenin ayrılmaz bir parçasıdır.

Pete LePage
Robert Nyman

İyi bir hata bildirmek zor değildir ancak biraz çalışma gerektirir. Hedefiniz bunu bulmak, asıl nedene ulaşmak ve en önemlisi de yolu vardır. Hızlı ilerleme kaydeden hatalar genellikle bir net beklentiler oluşur.

Hata olduğunu doğrulayın

İlk adım, neyin "doğru" olduğunu belirlemektir olması gerektiği gibidir.

Doğru davranış nedir?

MDN'deki ilgili API dokümanlarını kontrol edin veya teknik özellikler de vardır. Bu bilgiler, hangi API'nin gerçekten ve beklenen davranışın ne olduğunu açıkça belirtmelisiniz.

Farklı bir tarayıcıda çalışır mı?

Tarayıcılar arasında farklılık gösteren davranışa genellikle birlikte çalışabilirlik sorunu, özellikle de hatayı içeren tarayıcı ilginç. Chrome, Firefox, Safari ve Chrome tarayıcılarının en yeni sürümlerinde Muhtemelen BrowserStack gibi bir araç kullanarak.

Mümkünse sayfanın, kullanıcıların seslerini duyabilirsiniz. Chrome Geliştirici Araçları'nda User-Agent dizesini ayarlamayı deneyin kullanın.

Yakın zamanda yayınladığınız bir videoda bozuldu mu?

Bu, geçmişte beklendiği gibi çalıştı, ancak yakın zamanda yayınlanan bir tarayıcı sürümünde bozuk muydu? Böyle "regresyonlar" çok daha hızlı harekete geçilebilir, özellikle de bir çalıştığı sürüm numarası ve başarısız olduğu sürüm. Benzer araçlar BrowserStack, eski iletileri kontrol etmeyi kolaylaştırabilir tarayıcı sürümleri ve bisect-builds aracı (Chromium için) değişikliği çok verimli bir şekilde aramaya olanak tanır.

Sorun bir regresyonsa ve yeniden oluşturulabiliyorsa kök neden genellikle bulunur ve hızlıca düzeltilir.

Başkaları da aynı sorunla karşılaşıyor mu?

Sorun yaşıyorsanız diğer geliştiricilerin de aynı sorunla karşılaşma olasılığı yüksektir. İlk olarak, hatayı Stack Overflow'da aramayı deneyin. Bu, soyut bir problemi belirli bir bozuk API'ye dönüştürmenize yardımcı olabilir. Bu, hata düzeltilene kadar kısa vadeli bir çözüm bulmanıza yardımcı olabilir.

Daha önce bildirildi mi?

Hatanın ne olduğuna dair bir fikir edindikten sonra, sıra, tarayıcı hata veritabanında arama yapılarak zaten bildirildi.

Sorunu açıklayan mevcut bir hata bulursanız desteğinizi ekleyin veya yorum yaparak hataya yıldız ekleyebilirsiniz. Birçok sitede kendinizi CC listesine ekleyebilir ve hata değiştiğinde güncelleme alabilirsiniz.

Hata hakkında yorum yapmaya karar verirseniz, web sitenizi etkiler. "+1" eklemekten kaçının stil yorumları (hata izleyicileri olarak) genelde her yorum için e-posta gönderir.

Hatayı bildirin

Hata daha önce bildirilmediyse tarayıcı tedarikçi firmasına bunu bildirme zamanıdır. hesap ekiplerinizle görüşün.

Küçültülmüş test durumu oluşturma

Mozilla'nın küçültülmüş test durumu oluşturma. Bir uzun lafın kısası; sorunun açıklaması iyi bir başlangıç olsa da , sorun. Hızlı ilerleme olasılığını en üst düzeye çıkarmak için örnekte sorunu göstermek için gereken minimum kod. Minimum kod örneklem, büyük bir riskin olası sonuçlarını artırmak için düzeltiliyor.

Test durumunu en aza indirmek için birkaç ipucunu burada bulabilirsiniz:

  • Web sayfasını indirin, <base href="https://original.url"> ve hatanın yerel olarak mevcut olduğunu doğrulayın. Bu, aşağıdaki durumlarda canlı bir HTTPS sunucusu gerektirebilir: URL, HTTPS kullanıyor.
  • Yerel dosyaları, olabildiğince çok sayıda tarayıcının en yeni derlemelerinde test edin.
  • Her şeyi 1 dosyada toplamayı deneyin.
  • Hataya kadar kodu (gereksiz olduğunu bildiğiniz şeylerden başlayarak) kaldırın ortadan kalkar.
  • Çalışmanızı kaydedebilmek ve yapılan işlemleri geri alabilmek için sürüm denetimini kullanın yanlış.

Küçültülmüş test durumu barındırma

Küçültülmüş test durumunuzu barındırmak için iyi bir yer arıyorsanız kullanabileceğiniz birkaç iyi yer vardır:

Bu sitelerden bazılarının bir iframe'de içerik görüntülediğine dikkat edin. Bu içerik özelliklerin veya hataların farklı davranmasına neden olabilir.

Sorununuzu bildirme

Küçültülmüş test durumunuzu edindikten sonra hatayı bildirmeye hazırsınız demektir. Doğru hata izleme sitesine gidin ve yeni bir sorun oluşturun.

Net bir açıklama ve sorunun yeniden üretilmesi için gerekli adımları belirtin

Öncelikle, mühendislerin neyi hızlıca anlamasına yardımcı olmak için net bir açıklama ve sorunun önceliklendirilmesine yardımcı olmaktır.

When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.

Ardından, sorunun yeniden üretilmesi için gereken ayrıntılı adımları sağlayın. Küçültülmüş test durumunuz burada devreye girer.

What steps will reproduce the problem?
1. Go to https://basic-pwa.glitch.me/, open DevTools and look at the
   console tab.
2. Click the Install button in the page, you might need to interact with
   the page a bit before it becomes enabled.
3. Click Install on the browser modal install confirmation.

Son olarak, beklenen ve gerçek sonucu açıklayın.

What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)

What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)

Daha fazla bilgi için Hata raporu yazma yönergeleri başlıklı makaleye göz atın. MDN'de

Bonus: Sorunun ekran görüntüsünü veya ekran video kaydını ekleyin

Zorunlu olmasa da bazı durumlarda ekran görüntüsü eklemek faydalı olabilir. veya sorunun ekran video kaydını kullanabilirsiniz. Bu, özellikle hata mesajlarının yeniden oluşturmak için bazı tuhaf adımlar gerekebilir. Toplantılarda neler olduğunu, ekran video kaydı veya ekran görüntüsü eklemek sıkça yararlı olabilir.

Ortamla ilgili ayrıntıları ekleyin

Bazı hatalar yalnızca belirli işletim sistemlerinde veya yalnızca belirli işletim sistemlerinde Belirli ekran türleri (örneğin, düşük dpi veya yüksek dpi). Şunları yaptığınızdan emin olun: kullandığınız test ortamlarının ayrıntılarını da ekleyin.

Hatayı gönder

Son olarak hatayı gönderin. Daha sonra e-posta adresinize yanıt verebilirler. Genellikle araştırma sırasında ve hatayı düzeltirken veya teknik sorunları çözmek için sorunu tekrarlarlarsa iletişime geçebilirler.