setError() — Maydonga va root darajasiga qo'lda xato o'rnatish
setError() sintaksisi, server va manual xatolar, shouldFocus opsiyasi, backend 422 javoblarini integratsiya qilish va root xatolar.
45-dars
setError() — Custom error o'rnatish
setError(name, error, options?) — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, muayyan maydonga (field), ichki obyektlarga yoki butun forma darajasidagi root xatolariga qo'lda (custom / server / manual) validatsiya xatosi o'rnatish imkonini beradi.
U ayniqsa:
- Backend API'dan 422 (Unprocessable Entity) xatolari qaytganda server xabarini aynan o'sha input ostida ko'rsatishda,
- Ikki yoki undan ortiq maydon o'rtasidagi murakkab o'zaro bog'liqlikni (cross-field validation) tekshirishda,
- Muayyan shartli hodisalar va biznes mantiq xatolarini foydalanuvchiga yetkazishda juda qulaydir.
1. setError() sintaksisi va konfiguratsiya opsiyalari
setError(name, { type, message }, options?)
| Parametr / Opsiya | Turi | Tavsifi va vazifasi |
|---|---|---|
name |
Path<T> | "root" | "root.custom" |
Xato qo'yiladigan maydon nomi yoki umumiy forma xatosi kaliti. |
error.type |
string |
Xato turi (masalan: "server", "manual", "validate", "crossField"). |
error.message |
string |
Foydalanuvchiga ko'rsatiladigan tushunarli xato matni. |
options.shouldFocus |
boolean |
true berilsa, xato o'rnatilgach kursorni o'sha xatoli inputga avtomatik olib boradi. |
2. Real misol: Backend 422 xatosini maydonga bog'lash va shouldFocus
Quyidagi misolda serverga so'rov yuborilganda, agar email allaqachon ro'yxatdan o'tgan bo'lsa, backend javobiga ko'ra setError orqali xato aynan email maydoniga biriktiriladi va kursor o'sha maydonga yo'naltiriladi:
import { useForm, type SubmitHandler } from "react-hook-form";
type RegisterEmployeeForm = {
email: string;
departmentCode: string;
};
export function SetErrorExampleForm() {
const {
register,
handleSubmit,
setError,
formState: { errors, isSubmitting },
} = useForm<RegisterEmployeeForm>({
defaultValues: {
email: "",
departmentCode: "ENG",
},
});
const onSubmit: SubmitHandler<RegisterEmployeeForm> = async (data) => {
// API so'rovini simulyatsiya qilish
await new Promise((resolve) => setTimeout(resolve, 600));
// 1. Backend'dan kelgan maydon darajasidagi xatolikni bog'lash
if (data.email.trim().toLowerCase() === "[email protected]") {
setError(
"email",
{
type: "server",
message: "Ushbu email bilan xodim allaqachon ro'yxatdan o'tgan.",
},
{ shouldFocus: true } // Inputga avtomatik fokus beriladi
);
return;
}
// 2. Qo'lda (manual) maxsus biznes qoida xatosini qo'yish
if (data.departmentCode === "INVALID") {
setError("departmentCode", {
type: "manual",
message: "Bo'lim kodi noto'g'ri kiritilgan.",
});
return;
}
console.log("Xodim muvaffaqiyatli qo'shildi:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
<div>
<label htmlFor="empEmail">Ishchi emaili</label>
<input
id="empEmail"
type="email"
placeholder="[email protected]"
{...register("email", { required: "Email kiritish majburiy" })}
/>
{errors.email && (
<p style={{ color: "red" }} role="alert">
{errors.email.message}{" "}
<small style={{ color: "#666" }}>({errors.email.type})</small>
</p>
)}
</div>
<div style={{ marginTop: "1rem" }}>
<label htmlFor="deptCode">Bo'lim kodi</label>
<input
id="deptCode"
placeholder="Masalan: ENG"
{...register("departmentCode", { required: "Bo'lim kodi majburiy" })}
/>
{errors.departmentCode && (
<p style={{ color: "red" }} role="alert">
{errors.departmentCode.message}
</p>
)}
</div>
<button type="submit" disabled={isSubmitting} style={{ marginTop: "1.25rem" }}>
{isSubmitting ? "Yuborilmoqda..." : "Saqlash"}
</button>
</form>
);
}
3. Muhim amaliy eslatmalar
1. setError xatolarining tozalanishi
setError() orqali qo'yilgan xatolar doimiy emas:
- Foydalanuvchi o'sha inputga yana yozib o'zgartirganda (agar mode: "onChange" bo'lsa),
- Inputdan chiqib ketganda (blur bo'lganda),
clearErrors("email")yokireset()chaqirilganda, avtomatik tarzda qayta hisoblanadi va tozalanishi mumkin.
2. Butun formaga tegishli umumiy xatolar uchun "root"
Agar backenddan qaytgan xato aniq bir inputga (email yoki ismga) tegishli bo'lmasa (masalan: "Baza bilan aloqa uzildi" yoki "Kredit karta limitidan oshildi"), uni forma darajasida saqlash lozim:
setError("root.serverError", {
type: "server",
message: "Tizimda nosozlik. Iltimos, keyinroq urinib ko'ring.",
});
// UI'da ko'rsatish:
{errors.root?.serverError && <p>{errors.root.serverError.message}</p>}