Seriya: React Hook Form Dars 44

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'ich defaultValues holatiga qaytaradi.