apiErrorText
Lấy câu báo lỗi cho người dùng từ một lần gọi API hỏng: câu tiếng Việt của server nếu có, câu mất kết nối khi không tới được server, hoặc một câu dự phòng.
Cách dùng
app/pos/page.tsx
import { Alert } from "antd";
import { useApiClient } from "app/api";
import { apiErrorText, useRequest } from "app/hooks";
export default function PosPage() {
const api = useApiClient();
const { data, error } = useRequest(() => api.products.list({ pageSize: 100 }));
if (error) return <Alert type="error" message={apiErrorText(error, "Không tải được danh sách hàng")} />;
// …
}Chữ ký
app/hooks.ts
function apiErrorText(e: any, fallback?: string): string;Tham số
e: lỗi bắt được từuseApiClient()hoặcuseApi().fallback: câu dùng khi server không gửi câu nào, mặc định “Có lỗi xảy ra, vui lòng thử lại”.
Trả về
Một chuỗi, theo thứ tự ưu tiên:
- Không có phản hồi (mất mạng, server không trả lời): “Không kết nối được máy chủ — kiểm tra mạng rồi thử lại”.
message(hoặcerror) trong body lỗi{ error, message, code }của server.fallback, thay cho câu tiếng Anh kiểu “Request failed with status code 500”.
Ví dụ
Phần lớn trang không cần gọi hàm này. Với app dùng khung AppShell của manh/shell, mỗi lần gọi API hỏng tự hiện câu báo; useAction, submit và tableRequest cũng dùng sẵn hàm này. Gọi apiErrorText khi bạn hiện lỗi ở chỗ riêng, như một Alert trong trang.
Muốn một lần gọi không tự hiện lỗi thì truyền { silent: true } trong cấu hình axios của lần gọi đó.
Bước tiếp theo
Cập nhật