Skip to Content

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ặc useApi().
  • 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:

  1. 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”.
  2. message (hoặc error) trong body lỗi { error, message, code } của server.
  3. 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

  • Mã lỗi: dạng body lỗi và các mã server trả.
  • useApi: thử lại khi đọc lỗi và đăng xuất khi phiên hết hạn.
Cập nhật