Server Error Mapping — Backend xatolarini field'larga bog'lash
Backend (400, 422) xatolarini aniq field path'larga xaritalash, setError yordamida shouldFocus bilan fokuslash, normallashtirish va root.serverError zaxirasi.
87-dars
Server Error Mapping — Backend xatolarini field'larga bog'lash
Server Error Mapping (server xatolarini xaritalash) — bu backend REST API'dan (odatda 400 Bad Request yoki 422 Unprocessable Entity) qaytgan validatsiya va biznes-mantiq xatolarini formadagi aniq maydon yo'llariga (field paths: email, profile.phone, items.0.quantity) biriktirish va foydalanuvchiga aynan o'sha input ostida xato xabarini ko'rsatish jarayonidir.
Mijoz darajasidagi (frontend) barcha tekshiruvlar muvaffaqiyatli o'tgan taqdirda ham, faqat server tekshira oladigan holatlar mavjud:
- Unique xatoliklar:
emailyokiusernamebazada allaqachon mavjud; - Biznes cheklovlari:
promoCodemuddati tugagan yoki faollashtirishlar soni oshib ketgan; - Ombor qoldiqlari: Tanlangan tovar soni (
items.1.quantity) do'kon omboridagi qoldiqdan ko'p.
1. Nima uchun xaritalash (Mapping) funksiyasi shart?
Agar barcha server xatolarini sahifaning eng yuqorisida umumiy qilib chiqarib qo'ysangiz, foydalanuvchi aynan qaysi inputdagi ma'lumotni to'g'rilash kerakligini topa olmay qoladi.
Aksincha, xato aynan email maydoni ostida "Bu elektron pochta allaqachon ro'yxatdan o'tgan" deb qizil bilan chiqsa va kursor o'sha maydonga avtomatik fokuslansa, foydalanuvchi tajribasi (UX) a'lo darajada bo'ladi.
graph TD
A["Backend 422 Javobi (JSON)"] --> B["mapServerErrorsToForm(errorData, setError)"]
B -->|Tanish maydon bo'lsa| C["setError(field, { type: 'server', message }, { shouldFocus })"]
B -->|Noma'lum yoki umumiy xato bo'lsa| D["setError('root.serverError', { message })"]
C --> E["Foydalanuvchi birinchi xatoli inputga avtomatik fokuslanadi"]
2. Server yo'llarini normallashtirish (Path Normalization)
Backend tizimlari ko'pincha massiv xatolarini items[0].price ko'rinishida qaytaradi. React Hook Form esa nuqta sintaksisini (items.0.price) kutadi.
Xaritalash jarayonida qavslarni nuqtaga almashtirib olish tavsiya etiladi:
function normalizeServerPath(serverPath: string): string {
// "items[0].price" -> "items.0.price"
return serverPath.replace(/\[(\d+)\]/g, ".$1");
}
3. Real misol: Backend xatolarini xaritalash va avtofokus (shouldFocus)
Quyidagi to'liq namunada serverdan qaytgan xatolar ro'yxati mapServerErrorsToForm orqali qayta ishlanadi, birinchi xato chiqqan inputga avtomatik fokus beriladi (shouldFocus: index === 0) va formaga noma'lum xatolar root.serverError zaxirasiga yo'naltiriladi:
import React from "react";
import axios from "axios";
import { useForm, type FieldPath, type UseFormSetError, type SubmitHandler } from "react-hook-form";
// 1. Forma qiymatlari tipi
type CreateAccountFormValues = {
username: string;
email: string;
profile: {
phone: string;
};
};
// 2. Backend 422 javobining strukturasi
type BackendFieldErrorItem = {
field: string; // Masalan: "email", "username", "profile.phone"
message: string;
};
type BackendErrorResponse = {
message?: string;
errors?: BackendFieldErrorItem[];
};
// 3. Formada mavjud maydonlar ro'yxati (Type-guard uchun)
const KNOWN_FIELD_PATHS = new Set<FieldPath<CreateAccountFormValues>>([
"username",
"email",
"profile.phone",
]);
function isKnownFieldPath(
path: string
): path is FieldPath<CreateAccountFormValues> {
return KNOWN_FIELD_PATHS.has(path as FieldPath<CreateAccountFormValues>);
}
// 4. Server xatolarini RHF maydonlariga bog'lovchi yordamchi funksiya
function mapServerErrorsToForm(
errorData: BackendErrorResponse | undefined,
setError: UseFormSetError<CreateAccountFormValues>
) {
const fieldErrors = errorData?.errors ?? [];
let hasMappedFieldError = false;
fieldErrors.forEach((item, index) => {
// Qavsli yo'llarni nuqtali formatga o'giramiz
const normalizedPath = item.field.replace(/\[(\d+)\]/g, ".$1");
if (isKnownFieldPath(normalizedPath)) {
setError(
normalizedPath,
{
type: "server", // Server xatosi ekanligini bildiramiz
message: item.message,
},
// Faqat birinchi xatoli maydonga avtomatik kursor fokus beramiz
{ shouldFocus: index === 0 }
);
hasMappedFieldError = true;
}
});
// Agar aniq birorta maydonga mos kelmasa yoki umumiy xabar bo'lsa, root.serverError ga chiqaramiz
if (!hasMappedFieldError || errorData?.message) {
setError("root.serverError", {
type: "server",
message:
errorData?.message ||
"Kiritilgan ma'lumotlarni tekshiring, serverda xatolik aniqlandi.",
});
}
}
// 5. Asosiy forma komponenti
export function ServerErrorMappingForm() {
const {
register,
handleSubmit,
setError,
reset,
formState: { errors, isSubmitting },
} = useForm<CreateAccountFormValues>({
defaultValues: {
username: "",
email: "",
profile: {
phone: "",
},
},
});
const onSubmit: SubmitHandler<CreateAccountFormValues> = async (data) => {
try {
// Backend ro'yxatdan o'tish endpointi
await axios.post("/api/auth/register", data);
alert("Tabriklaymiz! Hisob muvaffaqiyatli yaratildi.");
reset();
} catch (error) {
if (axios.isAxiosError<BackendErrorResponse>(error)) {
// Backend'dan qaytgan xatolarni formaga ulaymiz
mapServerErrorsToForm(error.response?.data, setError);
} else {
setError("root.serverError", {
type: "unknown",
message: "Tarmoq bilan aloqa uzildi. Qayta urinib ko'ring.",
});
}
}
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate style={{ maxWidth: "460px" }}>
<h3 style={{ marginBottom: "16px" }}>Yangi hisob ochish</h3>
{/* Umumiy server xabari banneri */}
{errors.root?.serverError && (
<div
role="alert"
style={{
padding: "10px 14px",
background: "#fef2f2",
border: "1px solid #f87171",
borderRadius: "6px",
color: "#b91c1c",
fontSize: "13px",
marginBottom: "14px",
}}
>
{errors.root.serverError.message}
</div>
)}
{/* Foydalanuvchi nomi (username) */}
<div style={{ marginBottom: "14px" }}>
<label htmlFor="username" style={{ display: "block", fontWeight: 600, fontSize: "13px", marginBottom: "4px" }}>
Foydalanuvchi nomi (Username) *
</label>
<input
id="username"
disabled={isSubmitting}
{...register("username", { required: "Username kiritish majburiy" })}
placeholder="dev_user"
style={{ width: "100%", padding: "8px", boxSizing: "border-box" }}
aria-invalid={Boolean(errors.username)}
/>
{errors.username && (
<p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "4px" }}>
{errors.username.message}
</p>
)}
</div>
{/* Elektron pochta */}
<div style={{ marginBottom: "14px" }}>
<label htmlFor="email" style={{ display: "block", fontWeight: 600, fontSize: "13px", marginBottom: "4px" }}>
Elektron pochta *
</label>
<input
id="email"
type="email"
disabled={isSubmitting}
{...register("email", {
required: "Email kiritish majburiy",
pattern: {
value: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
message: "Email formati noto'g'ri",
},
})}
placeholder="[email protected]"
style={{ width: "100%", padding: "8px", boxSizing: "border-box" }}
aria-invalid={Boolean(errors.email)}
/>
{errors.email && (
<p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "4px" }}>
{errors.email.message}
</p>
)}
</div>
{/* Telefon raqam */}
<div style={{ marginBottom: "20px" }}>
<label htmlFor="phone" style={{ display: "block", fontWeight: 600, fontSize: "13px", marginBottom: "4px" }}>
Telefon raqami *
</label>
<input
id="phone"
disabled={isSubmitting}
{...register("profile.phone", { required: "Telefon raqami majburiy" })}
placeholder="+998 90 123 45 67"
style={{ width: "100%", padding: "8px", boxSizing: "border-box" }}
aria-invalid={Boolean(errors.profile?.phone)}
/>
{errors.profile?.phone && (
<p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "4px" }}>
{errors.profile.phone.message}
</p>
)}
</div>
<button
type="submit"
disabled={isSubmitting}
style={{
padding: "10px 22px",
background: isSubmitting ? "#94a3b8" : "#2563eb",
color: "#fff",
border: "none",
borderRadius: "6px",
cursor: isSubmitting ? "not-allowed" : "pointer",
fontWeight: 600,
}}
>
{isSubmitting ? "Tekshirilmoqda..." : "Ro'yxatdan o'tish"}
</button>
</form>
);
}
4. Muhim amaliy jihatlar
- Server xatolarining tozalanishi:
Foydalanuvchi xato chiqqan inputga qayta bosib, yangi matn yoza boshlaganda (onChange), React Hook Form
type: "server"deb belgilangan xatoni avtomatik o'chiradi. Natijada eskirgan xatolik ekranda qolib ketmaydi. - Noma'lum kalitlardan himoyalanish (
isKnownFieldPath): Backend ba'zan formaga bevosita tegishli bo'lmagan ichki kalitlar (masalan,metadata.internal_codeyokiip_address) bo'yicha xato qaytarishi mumkin. Agar siz ularni to'g'ridan-to'g'risetErrorga bersangiz, foydalanuvchi ularni ekranda ko'rmaydi. Shuning uchun noma'lum kalitlarniroot.serverErrorga yo'naltirish shart. { shouldFocus: index === 0 }afzalligi: Agar formada 5 ta xato qaytsa, bir vaqtning o'zida hammasiga fokus berish sahifaning sakrab ketishiga sabab bo'ladi. Faqat eng birinchi xatoli (index === 0) maydonga kursor qaratish eng toza UX hisoblanadi.