Tarayıcılarında bulduğunuz sorunları tarayıcı tedarikçilerine bildirmek, web platformunu daha iyi hale getirmenin ayrılmaz bir parçasıdır.
İyi bir hata bildirimi oluşturmak biraz çaba gerektirir. Hedefiniz, tarayıcı mühendislerinin bozuk olanı bulmasını, temel nedene ulaşmasını ve en önemlisi bunu düzeltmenin bir yolunu bulmasını mümkün olduğunca kolaylaştırmak olmalıdır. Hızlı ilerleme kaydeden hatalar, net bir beklenen davranışla hızlı bir şekilde yeniden üretilebilir.
Hata olduğunu doğrulama
İlk adım, "doğru" davranışın ne olması gerektiğini belirlemektir.
Doğru davranış nedir?
MDN'deki ilgili API belgelerine göz atın veya ilgili spesifikasyonları bulmaya çalışın. Bu bilgiler, hangi API'nin bozuk olduğunu, nerede bozuk olduğunu ve beklenen davranışın ne olduğunu belirlemenize yardımcı olabilir.
Farklı bir tarayıcıda çalışıyor mu?
Tarayıcılar arasında farklılık gösteren davranışlar, özellikle de hatayı içeren tarayıcı farklı olduğunda, birlikte çalışabilirlik sorunu olarak genellikle daha yüksek önceliğe sahiptir. Chrome, Firefox, Safari ve Edge'in en yeni sürümlerinde test yapmayı deneyin. Bunun için BrowserStack gibi bir araç kullanabilirsiniz.
Mümkünse sayfanın, kullanıcı aracısı algılama nedeniyle kasıtlı olarak farklı davranmadığından emin olun. Chrome Geliştirici Araçları'nda User-Agent dizesini başka bir tarayıcıya ayarlamayı deneyin.
Yakın zamanda yayınlanan bir sürümde mi bozuldu?
Bu özellik geçmişte beklendiği gibi çalışıyor ancak tarayıcının son sürümünde çalışmıyor mu? Bu tür gerilemeler, özellikle çalıştığı bir sürüm numarası ve başarısız olduğu bir sürüm sağlarsanız çok daha hızlı bir şekilde düzeltilebilir. Eski tarayıcı sürümlerini kontrol etmek için BrowserStack gibi araçları kullanabilirsiniz. Değişikliği aramak için bisect-builds aracı (Chromium için) gibi araçları kullanın.
Sorun bir gerilemeyse ve yeniden üretilebiliyorsa temel neden genellikle hızlı bir şekilde bulunup düzeltilebilir.
Diğer kullanıcılar da aynı sorunu yaşıyor mu?
Sorun yaşıyorsanız diğer geliştiriciler de büyük olasılıkla aynı sorunları yaşıyordur. Öncelikle hatayı Stack Overflow'da aramayı deneyin. Bu sayede soyut bir sorunu belirli bir bozuk API'ye dönüştürebilir ve hata düzeltilene kadar kısa vadeli bir geçici çözüm bulabilirsiniz.
Daha önce bildirildi mi?
Hatanın ne olduğu hakkında bir fikriniz olduğunda, tarayıcı hata veritabanında arama yaparak hatanın daha önce bildirilip bildirilmediğini kontrol etmeniz gerekir.
- Chromium tabanlı tarayıcılar: https://crbug.com
- Firefox: https://bugzilla.mozilla.org/
- Safari ve WebKit tabanlı tarayıcılar: https://bugs.webkit.org/
Sorunu açıklayan mevcut bir hata bulursanız hataya yıldız ekleyerek, favorilere ekleyerek veya yorum yaparak desteğinizi ekleyin. Birçok sitede kendinizi CC listesine ekleyebilir ve hata değiştiğinde güncellemeleri alabilirsiniz.
Hata hakkında yorum yapmaya karar verirseniz hatanın web sitenizi nasıl etkilediğiyle ilgili bilgileri ekleyin. Hata izleyiciler genellikle her yorum için e-posta gönderdiğinden "+1" tarzı yorumlar eklemekten kaçının.
Hatayı bildirme
Hata daha önce bildirilmediyse tarayıcı tedarikçisine bildirme zamanı gelmiştir.
Küçültülmüş bir test durumu oluşturma
Mozilla'nın küçültülmüş test durumu oluşturma hakkında mükemmel bir makalesi vardır. Özetlemek gerekirse, sorunun açıklaması iyi bir başlangıç olsa da hatada sorunu gösteren bağlantılı bir demo sunmak en iyi yöntemdir. Hızlı ilerleme şansını en üst düzeye çıkarmak için örnek, sorunu göstermek için gereken minimum kodu içermelidir. Minimum kod örneği, hatanızın düzeltilme olasılığını artırmak için yapabileceğiniz en önemli şeydir.
Test durumunu küçültmek için birkaç ipucu:
- Web sayfasını indirin,
<base href="https://original.url">ekleyin ve hatanın yerel olarak mevcut olduğunu doğrulayın. URL'de HTTPS kullanılıyorsa canlı bir HTTPS sunucusu gerekebilir. - Yerel dosyaları, mümkün olduğunca çok tarayıcının en son sürümlerinde test edin.
- Her şeyi tek bir dosyada toplamaya çalışın.
- Hata ortadan kalkana kadar kodu kaldırın (gereksiz olduğunu bildiğiniz şeylerle başlayın).
- Çalışmanızı kaydedebilmek ve yanlış giden şeyleri geri alabilmek için sürüm denetimini kullanın.
Küçültülmüş bir test durumu barındırma
Sadeleştirilmiş test durumunuzu barındırabileceğiniz iyi bir yer arıyorsanız birkaç iyi seçenek mevcuttur:
Bu sitelerin birçoğunun içeriği iframe içinde gösterdiğini ve bunun, özelliklerin veya hataların farklı şekilde davranmasına neden olabileceğini unutmayın.
Sorununuzu bildirme
Küçültülmüş test durumunuzu elde ettikten sonra hatayı bildirmeye hazırsınız demektir. Doğru hata izleme sitesine gidin ve yeni bir sorun oluşturun.
- Chromium tabanlı tarayıcılar - https://crbug.com/new
- Firefox - https://bugzilla.mozilla.org/
- Safari ve WebKit tabanlı tarayıcılar: https://bugs.webkit.org/
Açık açıklamalar ve tekrarlama adımları ekleyin
Öncelikle, mühendislerin sorunun ne olduğunu hızlıca anlamasına ve sorunu önceliklendirmesine yardımcı olmak için net bir açıklama sağlayın.
When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.
Ardından, sorunu yeniden oluşturmak için gereken ayrıntılı adımları belirtin ve 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 MDN'deki Hata raporu yazma yönergeleri'ne göz atın.
Bonus: Sorunun ekran görüntüsünü veya ekran videosunu ekleyin
Zorunlu olmasa da sorunun ekran görüntüsünü veya ekran video kaydını eklemek genellikle faydalı olur. Bu, özellikle birkaç adımdan veya olağan dışı etkinlikten sonra hatalar oluştuğunda faydalıdır. Ekran kayıtları ve ekran görüntüleri, tarayıcı mühendislerine ne olduğunu genellikle daha iyi gösterebilir.
Ortamla ilgili ayrıntıları ekleyin
Bazı hatalar yalnızca belirli işletim sistemlerinde veya yalnızca belirli ekran türlerinde (ör. düşük DPI veya yüksek DPI) yeniden oluşturulabilir. Kullandığınız test ortamlarının ayrıntılarını eklediğinizden emin olun.
Hatayı gönderme
Son olarak hata bildirimini gönderin. Hata ile ilgili yanıtlar için e-postanızı kontrol edin. İnceleme sırasında mühendislerin ek soruları olabilir. Sorunu yeniden oluşturmakta zorlanırlarsa sizinle iletişime geçebilirler.