clearErrors() — Validation xatolarini dasturiy tozalash
clearErrors() metodi, barcha yoki ayrim maydon xatolarini tozalash, root xatolar bilan ishlash va qayta validatsiya qoidalari.
44-dars
clearErrors() — Validation xatolarini tozalash
clearErrors(name?) — bu useForm() (yoki useFormContext()) qaytaradigan funksiya bo'lib, errors obyektidagi mavjud validatsiya xatolarini (hamda qo'lda qo'yilgan custom/server xatolarni) dasturiy tarzda o'chirish imkonini beradi.
Eng muhim jihati: clearErrors() input qiymatini o'zgartirmaydi — u shunchaki ko'rsatilgan xato holatini tozalaydi va ekrandagi ogohlantirish xabarini yashiradi.
U asosan:
- Foydalanuvchi xato banneri yoki xabari yonidagi yopish tugmasini ("x") bosganda,
- Bog'liq maydonlar o'zgarganda eski xatoliklarni olib tashlashda,
- Serverdan qaytgan global yoki lokal xatolar bartaraf etilganda qo'llaniladi.
1. clearErrors() ni chaqirish usullari
| Chaqirish usuli | Nimani tozalaydi? | Qachon ishlatiladi? |
|---|---|---|
clearErrors() (argumentsiz) |
Formadagi barcha maydon xatolarini (jumladan root xatolarini ham) tozalaydi. |
Barcha xabarlarni birdaniga yashirish yoki panel tozalanayotganda. |
clearErrors("fieldName") |
Faqat ko'rsatilgan bitta maydon xatosini tozalaydi. | Muayyan input xabarini qo'lda olib tashlashda. |
clearErrors(["a", "b"]) |
Massivda berilgan bir nechta maydon xatolarini tozalaydi. | O'zaro bog'liq bir nechta maydon xatosini bir vaqtda tozalashda. |
clearErrors("root") yoki clearErrors("root.server") |
Butun forma uchun belgilangan root xatosini tozalaydi. |
Server xatosi bannerini yopishda. |
2. Real misol: Bitta xato, guruh xatolari va server xatosini tozalash
Quyidagi misolda email va to'liq ism maydonlari uchun xatolarni alohida yopish, server xatosini simulyatsiya qilib uni tozalash hamda barcha xatolarni birdaniga o'chirish ko'rsatilgan:
import { useForm, type SubmitHandler } from "react-hook-form";
type InviteFormValues = {
email: string;
fullName: string;
};
export function ClearErrorsForm() {
const {
register,
handleSubmit,
clearErrors,
setError,
formState: { errors },
} = useForm<InviteFormValues>({
defaultValues: {
email: "",
fullName: "",
},
});
// Server xatosini simulyatsiya qilish
const handleSimulateServerError = () => {
setError("root.server", {
type: "server",
message: "Taklif yuborish xizmati vaqtincha mavjud emas. Keyinroq urinib ko'ring.",
});
};
const onSubmit: SubmitHandler<InviteFormValues> = (data) => {
clearErrors();
console.log("Taklif yuborildi:", data);
};
return (
<form onSubmit={handleSubmit(onSubmit)} noValidate>
{/* 1. Global server xatosi banneri */}
{errors.root?.server && (
<div
role="alert"
style={{
padding: "10px",
marginBottom: "1rem",
backgroundColor: "#fef2f2",
border: "1px solid #fecaca",
borderRadius: "4px",
color: "#991b1b",
display: "flex",
justifyContent: "space-between",
}}
>
<span>{errors.root.server.message}</span>
<button
type="button"
onClick={() => clearErrors("root.server")}
style={{ marginLeft: "10px" }}
>
Yopish
</button>
</div>
)}
{/* 2. Email maydoni */}
<div>
<label htmlFor="inviteEmail">Email manzili</label>
<input
id="inviteEmail"
type="email"
{...register("email", { required: "Email kiritish majburiy" })}
/>
{errors.email && (
<div style={{ marginTop: "4px" }}>
<span style={{ color: "red" }} role="alert">
{errors.email.message}
</span>
<button
type="button"
onClick={() => clearErrors("email")}
style={{ marginLeft: "8px", fontSize: "0.8rem" }}
>
Xatoni yopish
</button>
</div>
)}
</div>
{/* 3. To'liq ism maydoni */}
<div style={{ marginTop: "1rem" }}>
<label htmlFor="inviteFullName">To'liq ism</label>
<input
id="inviteFullName"
{...register("fullName", { required: "To'liq ism majburiy" })}
/>
{errors.fullName && (
<div style={{ marginTop: "4px" }}>
<span style={{ color: "red" }} role="alert">
{errors.fullName.message}
</span>
<button
type="button"
onClick={() => clearErrors("fullName")}
style={{ marginLeft: "8px", fontSize: "0.8rem" }}
>
Xatoni yopish
</button>
</div>
)}
</div>
{/* 4. Turli xil tozalash tugmalari */}
<div style={{ marginTop: "1.25rem", display: "flex", gap: "0.5rem", flexWrap: "wrap" }}>
<button type="submit">Yuborish</button>
<button
type="button"
onClick={() => clearErrors(["email", "fullName"])}
>
Maydon xatolarini tozalash
</button>
<button type="button" onClick={() => clearErrors()}>
Barcha xatolarni tozalash
</button>
<button type="button" onClick={handleSimulateServerError}>
Server xatosini test qilish
</button>
</div>
</form>
);
}
3. Muhim amaliy eslatmalar
1. Keyingi validatsiyada xato yana qaytishi mumkin
clearErrors() chaqirilganda xato errors obyektidan o'chiriladi. Ammo agar maydon qiymati hali ham talabga javob bermasa (masalan, required input bo'sh turgan bo'lsa), foydalanuvchi inputga qayta kirib chiqqanda (blur) yoki forma yuborilganda (submit), validatsiya qoidalari qayta ishga tushib, xatoni yana ko'rsatadi.
2. clearErrors() vs resetField()
clearErrors("field")— input ichidagi qiymatga teginmaydi, faqatgina xato holatini olib tashlaydi.resetField("field")— ham xatolarni tozalaydi, ham maydon qiymatini boshlang'ichdefaultValuesholatiga qaytaradi.