Giriş
🎯 Bu modül ne yapar?
System modülü, hata sayfası yönetimini test etmenizi sağlar - 404 ve 500 hatalarını simüle ederek hata sayfalarınızın doğru bir şekilde görüntülendiğini doğrulamanıza yardımcı olur, böylece kullanıcılar gerçek sorunlarla karşılaşmadan önce uygun hata yönetimini sağlarsınız.
Bunu hata test etme aracınız olarak düşünün - talep üzerine test hataları tetikleyin, hata sayfalarının düzgün bir şekilde görüntülendiğini doğrulayın ve hata yönetimi mantığınızın beklendiği gibi çalıştığından emin olun, üretimi bozmayın.
📖 Basit Açıklama
Her uygulamanın uygun hata yönetimine ihtiyacı vard ır:
- 🔍 404 Bulunamadı - Sayfa mevcut değil
- 💥 500 Sunucu Hatası - Sunucu içi hata
- 🎨 Özel Hata Sayfaları - Markalı hata deneyimi
- 🔄 Hata Kaydı - Hata oluşumlarını takip et
- 📊 Hata İzleme - Sorunları erken tespit et
- ✅ Hata Testi - Hata sayfalarının çalıştığını doğrula
Sorunlar:
- 🔍 Doğrulama yok - Hata sayfaları bozuk olabilir
- 🎨 Kötü UX - Çirkin varsayılan hata sayfaları
- 🔄 İzleme yok - Hataların ne zaman oluştuğunu bilmiyorsunuz
- 📊 İzleme yok - Sorunları tespit edemiyorsunuz
System çözümü:
Faydalar:
- 🔍 Doğrulanmış - Hata sayfalarının çalıştığını bilin
- 🎨 Daha İyi UX - Özel markalı hata sayfaları
- 🔄 İzlenmiş - Hata oluşumlarını kaydedin
- 📊 İzlenmiş - Sorunları erken tespit edin
✨ Temel Kavramlar
System Modülü Nedir?
System modülü test araçları sağlar:
- Hata Testi - 404/500 hatalarını simüle et
- Hata Sayfası Doğrulama - Hata sayfalarının görüntülendiğini doğrula
- Hata Yönetimi Doğrulama - Hata mantığını test et
- Geliştirme Aracı - Geliştirme/test sırasında kullan
- Üretim için değil - Canlı kodda kullanmayın
Hata Türleri
| Hata Kodu | İsim | Ne Zaman Oluşur | Kullanım Durumu |
|---|---|---|---|
| 404 | Bulunamadı | İstenen kaynak mevcut değil | Sayfa bulunamadı, ürün eksik |
| 500 | Sunucu Hatası | Sunucu tarafında hata oluştu | Veritabanı hatası, kod hatası |
Test İş Akışı
1. Hata sayfalarını geliştir
(Özel 404 ve 500 sayfaları)
↓
2. Hata yönetimini uygula
(Try/catch, hata sın ırları)
↓
3. System modülü ile test et
(System.test404(), System.test500())
↓
4. Hata sayfalarının görüntülendiğini doğrula
(UI'yi kontrol et, kayıt, izleme)
↓
5. Güvenle dağıt
(Hata yönetiminin çalıştığını bilin)
Neden System Modülünü Kullanmalıyım?
| Faydası | Açıklama |
|---|---|
| Hata Doğrulama | Hata sayfalarını kullanıcılar görmeden test et |
| Geliştirme Aracı | Talep üzerine hataları tetikle |
| Hata Mantığı Testi | Hata yönetimi kodunu doğrula |
| Özel Hata Sayfaları | Markalı hata deneyimini sağla |
| Erken Tespit | Sorunları üretimden önce yakala |
📋 Bilmeniz Gerekenler
System Modülü Sadece Test İçin
Önemli: System modülünü yalnızca geliştirme ve test sırasında kullanın.
Neden?
- Test hataları gerçek kullanıcılara ulaşmamalıdır
- Sadece geliştirme/staging ortamlarında kullanın
- Üretim dağıtımından önce test kodunu kaldırın
Hata Testi En İyi Uygulamaları
Geliştirme sırasında hata sayfalarını test edin
Özel Hata Sayfaları
Daha iyi UX için özel hata sayfaları oluşturun
Hata Kaydı ve İzleme
Hata izlemeyi uygulayın
💡 Önemli Notlar
Sadece Geliştirme Aracı
Unutmayın: System modülü test içindir, üretim için değil.
Hata Testi vs Gerçek Hatalar
System hataları simüle edilir:
- Test hataları gerçek kullanıcıları etkilemez
- Hata yönetimi mantığını doğrulamak için kullanın
- Üretim dağıtımından önce kaldırın
Gerçek hatalar doğal olarak oluşur:
- Gerçek 404: Sayfa bulunamadı
- Gerçek 500: Sunucu hatası
- Try/catch ve hata sınırları ile yönetin
Özel Hata Sayfaları Gereklidir
System modülü yalnızca hataları tetikler - hata sayfalarını oluşturmalısınız
📊 Hızlı Referans Tablosu
| Yöntem | Açıklama | Fırlatır | Kullanım Durumu |
|---|---|---|---|
| test404() | 404 Bulunamadı hatasını simüle et | 404 Hatası | 404 hata sayfasını test et |
| test500() | 500 Sunucu Hatasını simüle et | 500 Hatası | 500 hata sayfasını test et |
❓ Sıkça Sorulan Sorular (SSS)
System modülünü ne zaman kullanmalıyım?
System modülünü yalnızca geliştirme ve test sırasında hata sayfalarınızın doğru çalıştığını doğrulamak için kullanın. Asla üretim kodunda kullanmayın - bu tamamen hata yönetimini doğrulamak için bir test aracıdır.
Özel hata sayfalarımı nasıl test ederim?
Geliştirme ortamınızda System.test404() veya System.test500() çağrısını yapın. Bu yöntemler, hata yönetimi mantığınızı tetikleyen hatalar fırlatır ve özel hata sayfalarının doğru bir şekilde görüntülendiğini doğrulamanıza olanak tanır.
test404() ve test500() arasındaki fark nedir?
test404() "Bulunamadı" hatasını (kaynak mevcut değil) simüle ederken, test500() "Sunucu Hatası"nı (sunucu tarafı hatası) simüle eder. Her ikisini de test ederek tüm hata senaryolarının düzgün bir şekilde ele alındığından emin olun.
System modülünü üretimde kullanabilir miyim?
Hayır! System modülü yalnızca geliştirme ve test içindir. Üretime dağıtmadan önce tüm System modülü test çağrılarını kaldırın. Üretim hataları için gerçek hata yönetimini (try/catch, hata sınırları) kullanın.
Özel hata sayfalarını nasıl oluşturabilirim?
Uygulamanızda 404 ve 500 hataları için özel hata sayfası bileşenleri oluşturun. Hataları yakalamak ve bu özel sayfaları görüntülemek için hata sınırlarını (React) veya çerçevenizdeki eşdeğer hata yönetimini kullanın.
System modülü tarafından tetiklenen hataları kaydetmeli miyim?
Evet, test hatalarını kaydetmek, hata izleme ve izleme sistemlerinizin doğru çalıştığını doğrulamaya yardımcı olur. Ancak, bunları gerçek üretim sorunlarıyla karışıklığı önlemek için açıkça test hataları olarak işaretleyin.
🎓 En İyi Uygulamalar
- Geliştirme sırasında hata sayfalarını test edin - Doğru bir şekilde görüntülendiklerini doğrulayın
- Sadece test ortamında kullanın - Asla üretimde değil
- Özel hata sayfalarını uygulayın - Varsayılan hatalardan daha iyi UX
- Hataları hata ayıklama için kaydedin - Ne yanlış gittiğini takip edin
- Hata sınırlarını test edin - React/Vue hata yönetimi
- Hata izlemeyi doğrulayın - İzlemenin çalıştığından emin olun
- Test kodunu kaldırın - Dağıtımdan önce temizleyin
- Hata yönetimini belgeleyin - Ekibin akışı anlamasına yardımcı olun
Modülün kullanıcı arayüzü hakkında daha fazla bilgi https://doc.oneentry.cloud/docs/category/system
System modülünün tanımı
OneEntry Platform'daki System modülü, hata sayfası yönlendirmelerini test etmek için yöntemler sağlar ve geliştiricilerin hata yönetim mekanizmalarının doğru çalıştığından emin olmalarına olanak tanır. defineOneEntry fonksiyonunu kullanarak, bu işlevselliklere erişmek için bir System nesnesi oluşturabilirsiniz. Modül, test404 ve test500 olmak üzere iki ana yöntem sunar. Her iki yöntem de kullanıcının bir hata sayfasına yönlendirildiği senaryoları simüle eder; özellikle 404 (Bulunamadı) ve 500 (Sunucu Hatası) sayfaları için. Bu araçlar, sistemin hata sayfalarının gerektiğinde doğru bir şekilde uygulandığını ve kullanıcılara görüntülendiğini doğrulamak için gereklidir.
const { System } = defineOneEntry( "your-project-url", { "token": "your-app-token" });