
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.
- 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.