DerslerCanlı sitenizdeki hatalar nasıl bulunur ve düzeltilir

Mini ders 30 / 30 · Sitenizi çalıştırın ve bakımını yapın

Ziyaretçi işlemini deneyin

Bu ders kimler için?

Ziyaretçilerin karşılaştığı hataları bulup düzeltmek isteyenler için. Sağlanan bozuk sayfayı kullanacaksınız; siz sorunu anlatıp ziyaretçi işlemini tekrarlarken kodlama asistanı kodu değiştirebilir.

Faydalı özelliği bozuk olsa bile sayfa açılabilir.

Bu derste ne öğreneceksiniz?

  • Yalnızca sayfa yüklenmesini kontrol etmek yerine gerçekten bozuk işlemi yeniden üretin.
  • Sınırlı asistan düzeltmesine yetecek güvenli bağlamı paylaşın.
  • Düzeltilen işlemi ve ilgili izleme durumunu doğrulayın.
Açıklama, çözülmüş örnek ve alıştırma

Başlamadan önce

Verilen ayrı alıştırma sitesi ve kodlama asistanı. İzleme bölümü için Sentry alıştırma projesi isteğe bağlıdır; yalnızca verilen yapay hataları gönderin, özel ziyaretçi verisi kullanmayın.

Başlamak için gereken beceriler

Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.

  1. Web sitenizi GitHub üzerinden nasıl yayımlarsınız?

    Bir alıştırma deposunu barındırma hizmetine bağlayın.

Tahmini süre: 19–31 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. İzleme sağlayıcısının kurulumu ve veriyi alması için bekleme ek süre gerektirir. Yereldeki yakalama çağrısı, alınmış bir uyarının kanıtı değildir.

Konuyu anlayalım

Sağlanan public klasörünü HTTP üzerinden sunup sayfayı açmasını asistandan isteyin. “Find contact section” kullanın. Sağlanan practice-R1 sürümü bilerek olmayan hedefi arar; bu yüzden durum Contact işleminin başarısız olduğunu bildirir.

Asistana tam düğmeyi, beklenen hedefi ve görünür sonucu söyleyin. Contact bölümü sayfada bulunurken düğme ona ulaşamayabilir; yalnızca yüklenen ana sayfaya bakmak sorunu kaçırırdı.

Somut bir örnek

Yararlı belirti raporu: “practice-R1’de Find contact section düğmesine bastım. Contact bölümünün açılmasını bekliyordum ama durum Contact action failed dedi.”

Verilen bozuk iletişim işlemi örneğini ayrı alıştırma sitesinde kullan. Düğme hatasını yeniden üret, sınırlı bir neden belirle ve yalnızca gerekeni değiştir. Aynı işlemi tekrarlamama ve önce/sonra karşılaştırmama yardım et. İzleme etkinse yalnızca yapay hataları ve kendi alıştırma projemi kullan; özel sayfa veya form verisi gönderme. Sırf çözüldü olarak işaretlendi diye sorunu düzelmiş sayma.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Verilen ziyaretçi işlemini denediğinizde ne başarısız oldu?

Çözülmüş örneği göster

Sağlanan practice-R1 örneğinde “Find contact section” başarısız olur; sayfa bilerek konmuş deneme hatası mesajını gösterir. Contact’a ulaşmasını bekliyordum. Ana sayfanın kendisi yüklendi; yalnızca sayfanın erişilebilirliğine bakmak bu düğme hatasını yakalamazdı.

İyi bir cevap neleri içermeli?

  • Gerçek düğmeyi, beklenen Contact sonucunu ve görünür hatayı belirtir.
  • Başarısız ziyaretçi işlemini sayfanın başarıyla yüklenmesinden ayırır.
Nasıl çalışır? (isteğe bağlı)

Canlı site hatasını bulun ve düzeltin

Ziyaretçinin yapamadığı işlemden başlayın, ardından raporla nedenini bulun.

İzleme, gerçek belirtiyi araştırabileceğiniz kodla ilişkilendirdiğinde yararlıdır. Bu deneme sayfası bilerek var olmayan bir iletişim öğesini arar; bu yüzden iletişim bölümüne ulaşma işlemi başarısız olur.

Kendi Sentry projenize yalnızca sabit, yapay bir hata göndeririz. Rapor yayım sürümü etiketi ve çağrı yığını konumu içerir; olay kaydı bu kanıtı ziyaretçinin yapmaya çalıştığı işle ilişkilendirir.

Çözülmüş örnek

Ana sayfanın kendisi başarıyla yüklenir. “Find contact section” düğmesine tıklamak başarısız olur; çünkü gerçek HTML’de id=contact varken betik #contact-missing arar.

Ek teknik alıştırma

HTTP 200 dönen ana sayfa kontrolü neden bu hatayı yakalayamaz?

Çözülmüş örneği göster

HTML doğru yüklenirken sonraki JavaScript işlemi başarısız olabilir. Yalnızca sayfa isteğini değil, iletişim bölümüne ulaşma işlemini tekrarlayın.

  • Sayfa yüklendikten sonra etkilenen etkileşimi test eder.
  • Erişilebilirlikle işlevin doğru çalışmasını ayırır.

Adım 1 · Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir

Yalnızca güvenli ve faydalı bağlam toplayın

Asistana özel ziyaretçi verisi olmadan kanıt verin.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

Asistana deneme dosyalarını, sayfa sürümünü ve önceki adımdaki belirtiyi verin. Bu, gerçek ziyaretçinin form metnini veya hesap bilgisini göndermeden yerel örneği incelemeye başlamak için yeterli.

İsteğe bağlı Sentry projesini kullanıyorsanız yalnızca herkese açık yükleyici değerini ayarlayın ve kontrollü hatayı yeniden üretmeden deneme izlemesini açın. Eşleşen deneme olayını ve verisini inceleyin. Sentry’de olay görünmesi, gelen kutusuna uyarı ulaşmasından ayrıdır.

Somut bir örnek

Sağlanan izinli hata “Practice: missing contact target”. Yararlı olay, gerçek kullanıcı mesajı, e-posta adresi veya hesap token’ı olmadan deneme sürümünü ve kaynak konumunu içerebilir.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Hangi bağlamı paylaşacak, hangi özel verileri hariç tutacaksınız?

Çözülmüş örneği göster

Sağlanan practice-R1 dosyalarını, “Find contact section” işlemini ve hata mesajını paylaşırdım. İzleme açıkken test projemde “Practice: missing contact target” ve eşleşen sürümü arardım. Ziyaretçi e-postalarını, form metnini ve hesap token’larını dışlardım; gelen kutusu uyarısı ayrı kontrol olarak kalır.

İyi bir cevap neleri içermeli?

  • Tekrarlanabilir yapay işlemi, deneme sürümünü ve ilgili dosya bağlamını paylaşır.
  • Gerçek ziyaretçi içeriğini dışlar; alınmış izleme olaylarını teslim edilmiş uyarılardan ayırır.
Nasıl çalışır? (isteğe bağlı)

Kontrollü tanılama raporu gönderin

Ham kullanıcı içeriği göndermeden araştırmaya yetecek veri toplayın.

Herkese açık proje yükleyici URL’sini START-HERE.txt açıklamasına göre yapılandırın. Betik SDK’yı yüklemeden önce başlatma geri çağrısını ayarlar, tracing/replay özelliklerini kapatır ve bu sabit deneme hatası için beforeSend izin listesi kullanır.

Dönen tanılama olayı istek verisini, kullanıcı verisini, gelişigüzel ek alanları ve önceki işlemlerin breadcrumb kayıtlarını içermez. Çağrı yığını dosya adlarından sorgu/hash çıkarılır. Gerçek sitede hassas tanılama verisinin her kaynağını inceleyin; sendDefaultPii=false tek başına serbest metin veya URL’lerde kişisel bilgi bulunmadığını garanti etmez.

beforeSend filtresi bilerek katıdır: yalnızca tam olarak “Practice: missing contact target” yapay mesajı gönderilir. Diğer mesajlar elenir. Deneme hatasının metnini değiştirirseniz izin listesini bilinçli güncelleyin; aksi halde olayın görünmemesi beklenen sonuçtur. Sırf panel hareketlensin diye filtreyi kaldırmayın; izin verilen olayın veri yükünü istenmeyen bilgiler açısından inceleyin.

Olay gelmiyorsa önce app.js içindeki sabit mesajı ve beforeSend izin listesini inceleyin. Eşleşmeyen olay artık yerelde filtrelendiğini belirten mesaj gösterir; gönderilmiş sayılmaz. URL ayrıştırıcısı göreli dosya adları için location.origin değerini temel alır; ayrıştıramadığı adı, hassas olabilecek özgününü iletmek yerine redacted ile değiştirir.

Yükleyicinin belgelenen data-lazy="no" seçeneği script.dataset.lazy="no" ile ayarlanır; tam SDK’nın erken yüklenmesini ister. Çağrı yığını dosya adlarında sorgu/hash çıkarıldıktan sonra yalnızca HTTP(S) kökeni/yolu kalır. Web dışı şemalar değişmeden aktarılmak yerine gizlenir.

Çözülmüş örnek

“Practice: missing contact target” gibi sabit hata mesajı bu alıştırmaya yeter. Bütün form nesnesini göndermek, eksik DOM hedefini bulmaya yardım etmeden risk ekler.

Sentry: tarayıcı yükleyicisi ve özel başlatma

Ek teknik alıştırma

Varsayılan kişisel veri toplamayı kapatmak, gelişigüzel hata mesajlarının gönderilmesini kendiliğinden güvenli kılar mı?

Çözülmüş örneği göster

Hayır. Gerçek olay veri yükünü inceleyin ve kendi kodunuzun gönderdiğini sınırlayın. Varsayılan kişisel veri toplama kapalıyken bile mesajlarda, URL’lerde, breadcrumb kayıtlarında ve ek alanlarda kişisel veri olabilir.

  • Uygulama metninin/URL’lerinin yine de özel veri içerebileceğini fark eder.
  • Açık ayıklama ve izin listesi uygular.

Adım 2 · Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir

Sınırlı tek bir düzeltme uygulayın

Değişiklikten sonra başarısız işlemi aynen tekrarlayın.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

Başarısız düğmenin hedefini mevcut Contact bölümüyle karşılaştırmasını asistandan isteyin. Sağlanan worked-solution/app.js küçük hedef düzeltmesini içerir; bu değişikliği uygulayıp düzeltilen deneme sürümünü practice-R2 diye etiketlesin.

Güncellenmiş practice-R2 sayfasını açıp aynı düğmeyi yeniden kullanın. Contact’a ulaşmalı ve “Contact section opened.” göstermeli. Yalnızca sürüm etiketini değiştirmek veya Sentry’de sorunu çözüldü işaretlemek düğmenin davranışını değiştirmez.

Somut bir örnek

Hatalı betik #contact-missing ararken HTML, Contact’ı #contact içinde tanımlar. Asistan eşleşmeyi düzeltebilir; sonucu düğmeyi yeniden kullanarak siz değerlendirirsiniz.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Ne değişti ve ilk işlemi tekrarladığınızda ne oldu?

Çözülmüş örneği göster

Sağlanan çözümde asistan aramayı eksik hedeften mevcut #contact bölümüne değiştirir ve sürümü practice-R2 diye etiketler. Beklenen tekrar testi, aynı düğmenin Contact’a ulaşıp “Contact section opened.” göstermesidir. Bu test olmadan izlemedeki çözüldü etiketi düzeltmeyi doğrulamaz.

İyi bir cevap neleri içermeli?

  • Küçük hedef düzeltmesini mevcut Contact bölümüyle ilişkilendirir.
  • Güncel sürümde aynı işlemi tekrarlar ve kullanıcıya görünür sonucu kontrol eder.
Nasıl çalışır? (isteğe bağlı)

Raporu eşleştirin, nedeni düzeltin ve yeniden test edin

Bir sorunu çözüldü diye etiketlemek kodu düzeltmez.

İzlemeyi açın, yapay hatayı tetikleyin ve hesabınızda gerçek olayı bulun. Yayım sürümünü ve yığın çerçevesini verilen kaynakla karşılaştırın. Olay gelmezse hata olmadığını varsaymadan önce yüklemeyi, engelleyicileri, proje yapılandırmasını ve ağdan iletimi inceleyin.

Betiği worked-solution/app.js ile değiştirin, yayım sürümü etiketini güncelleyin ve iletişim işlemini tekrarlayın. Doğru hedef kaydırılarak görünür olmalıdır. Panelde sorunu çözüldü diye işaretlemek bu davranış kontrolünün yerine geçmez.

Dosya değiştirme, kaynak düzeltmesinin küçük bir laboratuvar gösterimidir. Barındırılan deneme sitesinde değişen app.js ve sürüm etiketini commit edin, o sürümü inceleyip dağıtın, sonra herkese açık URL’sinde yeniden test edin. Yalnızca sorun durumunu veya sürüm etiketini değiştirmek seçici düzeltmesini uygulamaz.

Çözülmüş örnek

R1, #contact-missing üzerinde başarısız olur; R2, #contact kullanır. Anlamlı toparlanma kanıtı, iletişim işleminin düzeltilmiş sürümde artık çalışmasıdır.

Ek teknik alıştırma

Sorun çözüldü diye işaretli ama dağıtılmış betik hâlâ #contact-missing arıyor. Sorun giderildi mi?

Çözülmüş örneği göster

Hayır. Panel durumu betiği değiştiremez. Düzeltmeyi inceleme sürecinden geçirip dağıtın ve işlemi o sürümde doğrulayın.

  • Gerçekte dağıtılan kaynağı/sürümü kontrol eder.
  • Önceden başarısız olan işlemi tekrarlar.

Adım 3 · Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir

Faydalı bir olay notunu tamamlayın

Belirtiyi, düzeltmeyi ve doğrulamayı bağlantılı tutun.

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

incident-record.txt dosyasını özgün düğme hatası, küçük hedef düzeltmesi ve güncel sayfada aynı işlemin sonucu ile doldurun. Deneme değişikliğini yayımlarsanız yalnızca yerel dosyayı değil, tam yayımlanmış sürümü kontrol edin.

İsteğe bağlı izleme gözlemlerini ayrı tutun: Özgün olay Sentry’ye ulaştı mı, uyarı ayarladınız mı ve bildirim gerçekten geldi mi? Kayıt, sitenin bütünüyle hatasız olduğunu iddia etmek yerine düzeltilen görevi ve kalan eksikleri açıklamalı.

Somut bir örnek

Kısa olay notu practice-R1’deki başarısız Contact işlemini hedef düzeltmesine ve practice-R2’de başarılı tekrar testine bağlar. Yalnızca “sorun çözüldü” demek ziyaretçi sonucunu atlar.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Olay kaydını ve gerçekten düzeltilen işlemin kontrolünü sunun.

Hazırlanacak çıktı: Yeniden üretilen belirti, sınırlı değişiklik ve gerçekten başarılı yeniden sınamayı içeren kısa olay kaydı.

Çözülmüş örneği göster

Örnek olay kaydı: practice-R1’in Contact düğmesi hata bildirdi; asistan eksik hedefi düzeltti; practice-R2’de aynı düğme Contact’a ulaşıp başarı mesajını gösterdi. Yapay olay, deneme izleme projesinde ayrıca kontrol edildi. Uyarı kuralı ayarlanmadığı için bildirim teslimatı denenmedi. Bu kayıt, gelecekteki bütün site hatalarını değil o Contact hatasını kapsar.

İyi bir cevap neleri içermeli?

  • Özgün belirtiyi, odaklı değişikliği ve belirtilen sürümdeki gerçek aynı işlem tekrar testini ilişkilendirir.
  • Sağlayıcı olayı/uyarı gözlemlerini ayırır ve denenmemiş kalan kapsamı belirtir.
Nasıl çalışır? (isteğe bağlı)

Ödeviniz: işe yarar bir olay notu yazın

Sonraki araştırmacının hem nedeni hem kanıtı anlamasını sağlayın.

Olay kaydını hassas bilgileri gizlenmiş olay referansı, etkilenen işlem, kaynak çerçevesi, kök neden ve başarılı yeniden testle tamamlayın. Uyarı yapılandırırsanız gerçek bildirimi, olayın sistemde alınmasından ayrı doğrulayın.

Kendi deneme kopyanızda ikinci bir yapay hata ekleyip döngüyü tekrarlayın. Mesajları sabit tutup izin listesini bilinçli güncelleyin; gelişigüzel sayfa/form verisi göndererek izleme kapsamını genişletmeyin.

Çözülmüş örnek

“Eksik hedef seçicisi #contact-missing yerine #contact olarak düzeltildi; R2 yeniden testi geçti” ifadesi ne yapıldığını anlatır. “Sentry’de hata vardı; çözüldü” neden ve doğrulamayı belirsiz bırakır.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

Ek teknik alıştırma

Olay notu hazırlayın ve düzeltilmiş kullanıcı işleminin çalıştığını kanıtlayın.

Çözülmüş örneği göster

Yapılandırılmış deneme yükleyicisini açın ve tam yapay hatayı tetikleyin. Hata metnini değiştirirseniz katı izin listesini bilerek güncelleyin; izin listesinde olmayan mesajın elenmesi beklenir. Gerçekte alınan olayda yayım sürümünü/çerçeveyi ve istenmeyen verileri inceleyin.

Verilen düzeltilmiş betiği public/app.js olarak uygulayın ve RELEASE değerini practice-R2 yapın. O deneme sürümünü incelenmiş iş akışından geçirerek yayımlayın, sonra gerçek dağıtılmış URL’de Find contact section işlemini tekrarlayın. Yalnızca sürüm etiketini veya sorun durumunu değiştirmek seçiciyi düzeltemez.

Sorunun sistemde alınmasını, uyarı bildiriminin tesliminden ayrı kaydedin. Yapılandırılmış uyarı gelmeden önce olay görünebilir; kontrol edilene kadar her gözlemi ayrı beklemede tutun. Örnek olay notu hatayı, çerçeveyi, seçici değişikliğini ve kullanıcının görebildiği yeniden testi ilişkilendirir.

  • Belirtiyi, yayım sürümünü ve kaynaktaki nedeni ilişkilendirir.
  • Davranışı doğrular; olayın alınması ve bildirimin teslim edilmesi iddialarını ayrı tutar.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.