Giới thiệu
🎯 Mô-đun này làm gì?
Mô-đun System cho phép bạn kiểm tra xử lý trang lỗi - mô phỏng lỗi 404 và 500 để xác minh rằng các trang lỗi của bạn hiển thị đúng cách, giúp bạn đảm bảo xử lý lỗi đúng trước khi người dùng gặp phải các vấn đề thực sự.
Hãy coi đây là công cụ kiểm tra lỗi của bạn - kích hoạt lỗi thử nghiệm theo yêu cầu, xác minh rằng các trang lỗi được hiển thị đúng cách và đảm bảo rằng logic xử lý lỗi của bạn hoạt động như mong đợi mà không làm hỏng môi trường sản xuất.
📖 Giải thích đơn giản
Mỗi ứng dụng cần xử lý lỗi đúng cách:
- 🔍 404 Không tìm thấy - Trang không tồn tại
- 💥 500 Lỗi máy chủ - Lỗi máy chủ nội bộ
- 🎨 Trang lỗi tùy chỉnh - Trải nghiệm lỗi có thương hiệu
- 🔄 Ghi lại lỗi - Theo dõi sự cố lỗi
- 📊 Giám sát lỗi - Phát hiện vấn đề sớm
- ✅ Kiểm tra lỗi - Xác minh rằng các trang lỗi hoạt động
Vấn đề:
- 🔍 Không có xác thực - Các trang lỗi có thể bị hỏng
- 🎨 Trải nghiệm người dùng kém - Các trang lỗi mặc định xấu xí
- 🔄 Không theo dõi - Không biết khi nào lỗi xảy ra
- 📊 Không giám sát - Không thể phát hiện vấn đề
Giải pháp của System:
Lợi ích:
- 🔍 Đã xác thực - Biết rằng các trang lỗi hoạt động
- 🎨 Trải nghiệm người dùng tốt hơn - Các trang lỗi có thương hiệu tùy chỉnh
- 🔄 Được theo dõi - Ghi lại sự cố lỗi
- 📊 Được giám sát - Phát hiện vấn đề sớm
✨ Khái niệm chính
Mô-đun System là gì?
Mô-đun System cung cấp các tiện ích kiểm tra:
- Kiểm tra lỗi - Mô phỏng lỗi 404/500
- Xác thực trang lỗi - Xác minh rằng các trang lỗi được hiển thị
- Xác minh xử lý lỗi - Kiểm tra logic xử lý lỗi
- Công cụ phát triển - Sử dụng trong quá trình phát triển/kiểm tra
- Không dành cho sản xuất - Không sử dụng trong mã trực tiếp
Các loại lỗi
| Mã lỗi | Tên | Khi nào xảy ra | Trường hợp sử dụng |
|---|---|---|---|
| 404 | Không tìm thấy | Tài nguyên yêu cầu không tồn tại | Trang không tìm thấy, sản phẩm bị thiếu |
| 500 | Lỗi máy chủ nội bộ | Lỗi xảy ra ở phía máy chủ | Lỗi cơ sở dữ liệu, lỗi mã |
Quy trình kiểm tra
1. Develop error pages
(Custom 404 and 500 pages)
↓
2. Implement error handling
(Try/catch, error boundaries)
↓
3. Test with System module
(System.test404(), System.test500())
↓
4. Verify error pages display
(Check UI, logging, tracking)
↓
5. Deploy with confidence
(Know error handling works)
Tại sao sử dụng mô-đun System?
| Lợi ích | Mô tả |
|---|---|
| Xác thực lỗi | Kiểm tra các trang lỗi trước khi người dùng thấy chúng |
| Công cụ phát triển | Kích hoạt lỗi theo yêu cầu |
| Kiểm tra logic lỗi | Xác minh mã xử lý lỗi |
| Trang lỗi tùy chỉnh | Đảm bảo trải nghiệm lỗi có thương hiệu |
| Phát hiện sớm | Bắt các vấn đề trước khi sản xuất |
📋 Những điều bạn cần biết
Mô-đun System chỉ dành cho kiểm tra
Quan trọng: Chỉ sử dụng mô-đun System trong quá trình phát triển và kiểm tra.
Tại sao?
- Lỗi thử nghiệm không nên đến tay người dùng thực
- Chỉ sử dụng trong môi trường phát triển/ staging
- Xóa mã thử nghiệm trước khi triển khai sản xuất
Thực hành tốt nhất cho kiểm tra lỗi
Kiểm tra các trang lỗi trong quá trình phát triển
Trang lỗi tùy chỉnh
Tạo các trang lỗi tùy chỉnh để có trải nghiệm người dùng tốt hơn
Ghi lại và giám sát lỗi
Triển khai theo dõi lỗi
💡 Ghi chú quan trọng
Chỉ công cụ phát triển
Nhớ: Mô-đun System chỉ dành cho kiểm tra, không phải sản xuất.
Kiểm tra lỗi so với lỗi thực
Lỗi hệ thống được mô phỏng:
- Lỗi thử nghiệm không ảnh hưởng đến người dùng thực
- Sử dụng để xác minh logic xử lý lỗi
- Xóa trước khi triển khai sản xuất
Lỗi thực xảy ra tự nhiên:
- 404 thực: Trang không tìm thấy
- 500 thực: Lỗi máy chủ
- Xử lý bằng try/catch và biên giới lỗi
Cần trang lỗi tùy chỉnh
Mô-đun System chỉ kích hoạt lỗi - bạn phải tạo các trang lỗi
📊 Bảng tham khảo nhanh
| Phương thức | Mô tả | Ném | Trường hợp sử dụng |
|---|---|---|---|
| test404() | Mô phỏng lỗi 404 Không tìm thấy | 404 Error | Kiểm tra trang lỗi 404 |
| test500() | Mô phỏng lỗi 500 Máy chủ | 500 Error | Kiểm tra trang lỗi 500 |
❓ Câu hỏi thường gặp (FAQ)
Khi nào tôi nên sử dụng mô-đun System?
Chỉ sử dụng mô-đun System trong quá trình phát triển và kiểm tra để xác minh rằng các trang lỗi của bạn hoạt động đúng cách. Không bao giờ sử dụng nó trong mã sản xuất - đây hoàn toàn là một công cụ kiểm tra để xác thực xử lý lỗi.
Làm thế nào để tôi kiểm tra các trang lỗi tùy chỉnh của mình?
Gọi System.test404() hoặc System.test500() trong môi trường phát triển của bạn. Các phương thức này ném lỗi kích hoạt logic xử lý lỗi của bạn, cho phép bạn xác minh rằng các trang lỗi tùy chỉnh được hiển thị đúng cách.
Sự khác biệt giữa test404() và test500() là gì?
test404() mô phỏng lỗi "Không tìm thấy" (tài nguyên không tồn tại), trong khi test500() mô phỏng "Lỗi máy chủ nội bộ" (lỗi ở phía máy chủ). Kiểm tra cả hai để đảm bảo tất cả các kịch bản lỗi được xử lý đúng cách.
Tôi có thể sử dụng mô-đun System trong sản xuất không?
Không! Mô-đun System chỉ dành cho phát triển và kiểm tra. Xóa tất cả các cuộc gọi thử nghiệm của mô-đun System trước khi triển khai vào sản xuất. Sử dụng xử lý lỗi thực (try/catch, biên giới lỗi) cho các lỗi trong sản xuất.
Làm thế nào để tôi tạo các trang lỗi tùy chỉnh?
Tạo các thành phần trang lỗi dành riêng cho lỗi 404 và 500 trong ứng dụng của bạn. Sử dụng biên giới lỗi (React) hoặc xử lý lỗi tương đương trong khung của bạn để bắt lỗi và hiển thị các trang tùy chỉnh này.
Tôi có nên ghi lại các lỗi do mô-đun System kích hoạt không?
Có, ghi lại các lỗi thử nghiệm giúp xác minh rằng hệ thống theo dõi và giám sát lỗi của bạn hoạt động đúng cách. Tuy nhiên, hãy đánh dấu rõ ràng chúng là lỗi thử nghiệm để tránh nhầm lẫn với các vấn đề sản xuất thực sự.
🎓 Thực hành tốt nhất
- Kiểm tra các trang lỗi trong quá trình phát triển - Xác minh rằng chúng được hiển thị đúng cách
- Chỉ sử dụng trong môi trường thử nghiệm - Không bao giờ trong sản xuất
- Triển khai các trang lỗi tùy chỉnh - Trải nghiệm người dùng tốt hơn so với lỗi mặc định
- Ghi lại lỗi để gỡ lỗi - Theo dõi những gì đã sai
- Kiểm tra biên giới lỗi - Xử lý lỗi React/Vue
- Xác minh theo dõi lỗi - Đảm bảo giám sát hoạt động
- Xóa mã thử nghiệm - Dọn dẹp trước khi triển khai
- Tài liệu xử lý lỗi - Giúp đội ngũ hiểu quy trình
Thêm thông tin về giao diện người dùng của mô-đun https://doc.oneentry.cloud/docs/category/system
Định nghĩa của mô-đun System
Mô-đun System trong OneEntry Platform cung cấp các phương thức để kiểm tra việc chuyển hướng trang lỗi, cho phép các nhà phát triển đảm bảo rằng các cơ chế xử lý lỗi của họ hoạt động đúng cách. Bằng cách sử dụng hàm defineOneEntry, bạn có thể tạo một đối tượng System để truy cập các chức năng này. Mô-đun cung cấp hai phương thức chính: test404 và test500. Cả hai phương thức đều mô phỏng các tình huống mà người dùng được chuyển hướng đến một trang lỗi, cụ thể là các trang 404 (Không tìm thấy) và 500 (Lỗi máy chủ nội bộ). Những công cụ này rất cần thiết để xác minh rằng các trang lỗi của hệ thống được triển khai và hiển thị đúng cách cho người dùng khi cần thiết.
const { System } = defineOneEntry( "your-project-url", { "token": "your-app-token" });