Lewati ke konten utama

Pendahuluan

Trigger kesalahan uji (404, 500) sesuai permintaan untuk memverifikasi bahwa halaman kesalahan Anda dirender dengan benar, dan baca jumlah permintaan API proyek.

Informasi lebih lanjut tentang antarmuka pengguna modul ini https://doc.oneentry.cloud/docs/category/system

🎯 Apa yang dilakukan modul ini?​

Modul System menyediakan utilitas tingkat sistem. Ini memungkinkan Anda untuk menguji penanganan halaman kesalahan - mensimulasikan kesalahan 404 dan 500 untuk memverifikasi bahwa halaman kesalahan Anda ditampilkan dengan benar sebelum pengguna menghadapi masalah nyata - dan mengekspos getApiStat() untuk membaca jumlah permintaan API proyek.

Metode kesalahan (test404, test500) memicu pengalihan ke halaman kesalahan yang sesuai sehingga Anda dapat memastikan penanganan kesalahan Anda diimplementasikan dengan benar. Gunakan mereka selama pengembangan dan pengujian, tidak dalam kode produksi.

🚀 Memulai dengan Cepat​

Inisialisasi modul dari defineOneEntry:


const { System } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Baca jumlah permintaan API proyek:

// Returns an object with the API request count for the project.
const stat = await System.getApiStat();

console.log('API usage:', stat);

test404() dan test500() dilempar dengan sengaja untuk menguji logika penanganan Anda, jadi panggil mereka di dalam try/catch:

try {
  await System.test404();
} catch (error) {
  // Your 404 handling runs here.
  console.log('404 handler fired', error);
}

✨ Konsep Kunci​

Apa itu Modul System?​

Modul System menyediakan utilitas pengujian dan diagnostik:

  • Pengujian kesalahan - Mensimulasikan kesalahan 404 / 500 dengan test404() / test500()
  • Validasi halaman kesalahan - Mengonfirmasi bahwa halaman kesalahan kustom Anda dirender
  • Penggunaan API - Membaca jumlah permintaan API proyek dengan getApiStat()
  • Alat pengembangan - Gunakan metode kesalahan selama pengembangan/pengujian, tidak dalam produksi

Jenis Kesalahan​

Kode KesalahanNamaKapan TerjadiKasus Penggunaan
404Tidak DitemukanSumber daya yang diminta tidak adaHalaman tidak ditemukan, produk hilang
500Kesalahan Server InternalTerjadi kesalahan di sisi serverKegagalan database, kesalahan kode

Alur Kerja Pengujian​

1. Develop custom 404 and 500 pages
   ↓
2. Implement error handling (try/catch, error boundaries)
   ↓
3. Trigger errors with System.test404() / System.test500()
   ↓
4. Verify your error pages display correctly
   ↓
5. Remove the test calls before deploying to production

📋 Apa yang Perlu Anda Ketahui​

Metode kesalahan hanya untuk pengujian​

Gunakan test404() dan test500() hanya selama pengembangan dan pengujian - mereka melempar kesalahan untuk menguji logika penanganan Anda. Jalankan mereka di lingkungan pengembangan/staging, dan hapus panggilan uji sebelum produksi. Kesalahan 404/500 yang nyata harus ditangani dengan try/catch dan batasan kesalahan Anda sendiri.

Logging dan pemantauan adalah tanggung jawab Anda​

Modul System tidak mencatat atau memantau kesalahan. Logging dan pemantauan ada di aplikasi Anda sendiri atau alat pihak ketiga - gunakan metode uji untuk memicu kesalahan sehingga Anda dapat mengonfirmasi bahwa pelacakan Anda berfungsi.

Halaman kesalahan kustom adalah milik Anda untuk dibangun​

Modul hanya memicu kesalahan; Anda harus membuat halaman 404 dan 500 kustom serta logika penanganannya di aplikasi Anda.

📊 Tabel Referensi Cepat​

MetodeDeskripsiMelemparKasus Penggunaan
test404()Mensimulasikan kesalahan 404 Tidak Ditemukan404 ErrorUji halaman kesalahan 404
test500()Mensimulasikan Kesalahan Server 500500 ErrorUji halaman kesalahan 500
getApiStat()Mendapatkan jumlah permintaan API—Memantau penggunaan API

❓ Pertanyaan Umum (FAQ)​

Kapan saya harus menggunakan metode kesalahan?​

Gunakan test404() dan test500() hanya selama pengembangan dan pengujian untuk memverifikasi bahwa halaman kesalahan Anda berfungsi dengan benar. Jangan pernah menggunakannya dalam kode produksi - mereka murni alat pengujian untuk memvalidasi penanganan kesalahan.

Bagaimana cara menguji halaman kesalahan kustom saya?​

Panggil System.test404() atau System.test500() di lingkungan pengembangan Anda, di dalam try/catch. Metode ini melempar, memicu logika penanganan kesalahan Anda sehingga Anda dapat memverifikasi bahwa halaman kesalahan kustom dirender dengan benar.

Apa perbedaan antara test404() dan test500()?​

test404() mensimulasikan kesalahan "Tidak Ditemukan" (sumber daya tidak ada), sementara test500() mensimulasikan "Kesalahan Server Internal" (kegagalan di sisi server). Uji keduanya untuk memastikan semua skenario kesalahan ditangani dengan baik.

Apa yang dikembalikan oleh getApiStat()?​

Ini mengembalikan objek dengan jumlah permintaan API proyek, berguna untuk memantau penggunaan API.

🎓 Praktik Terbaik​

  • Gunakan metode kesalahan hanya di lingkungan pengujian - Jangan pernah memicu kesalahan uji di produksi.
  • Bungkus panggilan uji dalam try/catch - Baik test404() maupun test500() dilempar dengan sengaja.
  • Implementasikan halaman kesalahan kustom - Modul hanya memicu kesalahan; halaman adalah milik Anda untuk dibangun.
  • Verifikasi pelacakan kesalahan - Gunakan metode uji untuk mengonfirmasi bahwa pemantauan/logging Anda berfungsi.
  • Hapus panggilan uji sebelum penerapan - Bersihkan panggilan test404() / test500() sebelum produksi.

🔗 Dokumentasi Terkait​