Seriya: React Hook Form Dars 99

Production Best Practices — Real loyihalarda qo'llash standartlari

Katta va jiddiy production loyihalarda React Hook Form standartlari: qat'iy tiplashtirish, to'liq defaultValues, re-render intizomi, a11y, xavfsizlik va error handling.

99-dars

Production Best Practices — Real loyihalarda qo'llash standartlari

Oddiy o'quv qo'llanmalarida (tutorials) shakllar sodda va ideal sharoitda ko'rsatiladi. Ammo haqiqiy Production muhitida formalarga qo'yiladigan talablar ancha yuqori bo'ladi: sekin mobil internet, tarmoq xatolari, klaviaturada qotishlar bo'lmasligi, ko'zi ojiz foydalanuvchilar uchun qulaylik (accessibility / a11y), maxfiy ma'lumotlar xavfsizligi va o'nlab dasturchilar ishlaydigan katta kod bazasining tozaligi.

Ushbu darsda React Hook Form bo'yicha o'rganilgan barcha amaliy bilimlarni (tiplashtirish, validatsiya, dinamik maydonlar, arxitektura, persistence, a11y va performance) Production Checklist ko'rinishida yagona muhandislik standartiga jamlaymiz.


1. Production Form Mezonlari Xaritasi

graph TD
  Root["Production Form Standartlari"] --> T1["1. Qat'iy Tiplashtirish (TypeScript Generics)"]
  Root --> T2["2. To'liq va Aniq defaultValues"]
  Root --> T3["3. Re-render Intizomi (useWatch / useFormState)"]
  Root --> T4["4. Qatlamli Arxitektura (Types, Mappers, DTO)"]
  Root --> T5["5. Xavfsiz Async Submit & Double-Click Himoyasi"]
  Root --> T6["6. To'liq Accessibility (a11y: aria-*, useId)"]
  Root --> T7["7. Ma'lumotlar Maxfiyligi & Xavfsiz Draft"]

2. Real Loyihalardagi 7 ta Asosiy Standart

1. Qat'iy TypeScript Tiplashtirish

  • Hech qachon tipsiz useForm() yoki any ishlatilmaydi. Doimo useForm<FormValues>() generic parametri orqali to'liq tiplashtiriladi.
  • Qayta ishlatiladigan input wrapperlarida FieldValues va FieldPath<T> orqali type-safety ta'minlanadi.

2. To'liq va Mos defaultValues

  • Har bitta maydon uchun boshlang'ich qiymat ("", 0, false, [], null) majburiy ko'rsatiladi.
  • Bu undefined holatidagi inputlar controlled/uncontrolled ogohlantirishlarini (React warning) berishini to'xtatadi hamda isDirty, dirtyFields va reset() funksiyalarining mukammal ishlashini kafolatlaydi.

3. Performance va Re-render Intizomi

  • Katta formalarda argumentsiz watch() mutlaqo taqiqlanadi.
  • Bo'limlar va hisoblagichlarda faqat kerakli maydonlarga obuna bo'lish uchun useWatch({ control, name }) ishlatiladi.
  • Validatsiya rejimi odatda mode: "onBlur" va reValidateMode: "onChange" qilib sozlanadi.

4. Qatlamli Arxitektura va DTO Mapperlar

  • API qabul qiladigan format (Snake_case DTO) va UI shakl modeli (CamelCase FormValues) aralashtirilmaydi.
  • O'rtada sof toApiPayload() mapper funksiyasi turadi (barcha .trim(), sanalarni ISO formatga o'tkazish, bo'sh satrlarni null qilish shu yerda bajariladi).

5. Xavfsiz Async Submit va Double-Click Himoyasi

  • Submit tugmasiga disabled={isSubmitting} majburiy qo'yiladi.
  • Serverdan kelgan xatoliklar (400, 422) setError yordamida aynan xato qilgan maydon tagida chiqariladi va birinchi xatoga fokus qaratiladi (shouldFocus: true).
  • Vaqtinchalik tarmoq xatolarida foydalanuvchi ma'lumotlari aslo tozalanmaydi (reset() faqat 200 OK bo'lgandagina chaqiriladi).

6. To'liq Accessibility (a11y)

  • Brauzerning standart xunuk popuplarini o'chirish uchun <form noValidate> qo'yiladi.
  • useId yordamida <label htmlFor={id}> va <input id={id}> o'zaro mustahkam bog'lanadi.
  • Xato paydo bo'lganda aria-invalid="true" va aria-describedby={errorId} (matnda role="alert") bilan ekran o'quvchi dasturlarga (Screen Readers) xabar uzatiladi.
  • Formadagi barcha no-submit tugmalarga type="button" berilishi shart!

7. Maxfiy Ma'lumotlar Xavfsizligi

  • Parollar, CVV kodlar yoki pasport raqamlari brauzer localStorage yoki sessionStorage keshiga aslo saqlanmaydi.

3. To'liq Production Namunasi: Reliz chiqarish formasi

Quyidagi amaliy kodda yuqoridagi barcha 7 ta standart birlashtirilgan to'liq ishlab chiqarish darajasidagi komponent ko'rsatilgan:

import React, { useId, useRef } from "react";
import axios from "axios";
import {
  useForm,
  useWatch,
  type Control,
  type UseFormSetError,
  type SubmitHandler,
} from "react-hook-form";

// ==========================================
// 1. Tiplar qatlami
// ==========================================
export type ProjectReleaseFormValues = {
  projectName: string;
  versionTag: string;
  isHotfix: boolean;
  changelogNotes: string;
};

export type CreateReleaseApiPayload = {
  project_name: string;
  version_tag: string;
  is_hotfix: boolean;
  changelog_notes: string | null;
};

export type ReleaseApiError = {
  message?: string;
  fieldErrors?: Partial<Record<keyof ProjectReleaseFormValues, string>>;
};

const DEFAULT_RELEASE_VALUES: ProjectReleaseFormValues = {
  projectName: "",
  versionTag: "",
  isHotfix: false,
  changelogNotes: "",
};

// ==========================================
// 2. Mapperlar qatlami
// ==========================================
function toReleasePayload(values: ProjectReleaseFormValues): CreateReleaseApiPayload {
  return {
    project_name: values.projectName.trim(),
    version_tag: values.versionTag.trim(),
    is_hotfix: values.isHotfix,
    changelog_notes: values.changelogNotes.trim() || null,
  };
}

function mapReleaseServerErrors(
  errorData: ReleaseApiError | undefined,
  setError: UseFormSetError<ProjectReleaseFormValues>
) {
  let hasFieldError = false;

  if (errorData?.fieldErrors) {
    (
      Object.entries(errorData.fieldErrors) as [
        keyof ProjectReleaseFormValues,
        string | undefined
      ][]
    ).forEach(([field, message], index) => {
      if (message) {
        setError(field, { type: "server", message }, { shouldFocus: index === 0 });
        hasFieldError = true;
      }
    });
  }

  if (!hasFieldError || errorData?.message) {
    setError("root.serverError", {
      type: "server",
      message:
        errorData?.message || "Relizni saqlashda xatolik yuz berdi. Qayta urinib ko'ring.",
    });
  }
}

// Re-render hisoblagich nishoni
function RenderBadge({ name }: { name: string }) {
  const count = useRef(0);
  count.current += 1;
  return (
    <span className="text-xs px-2 py-0.5 rounded bg-gray-100 text-gray-700 font-mono">
      {name}: {count.current} render
    </span>
  );
}

// ==========================================
// 3. Izolyatsiya qilingan Badge Preview (useWatch)
// ==========================================
function ReleaseBadgePreview({
  control,
}: {
  control: Control<ProjectReleaseFormValues>;
}) {
  const [versionTag, isHotfix] = useWatch({
    control,
    name: ["versionTag", "isHotfix"],
  });

  const cleanTag = versionTag?.trim() || "v0.0.0";

  return (
    <div className="border border-indigo-200 bg-indigo-50/50 p-3 rounded-lg text-xs flex items-center justify-between">
      <span>
        Kutilayotgan reliz: <strong className="font-mono text-indigo-900">{cleanTag}</strong>{" "}
        {isHotfix ? (
          <span className="text-rose-600 font-bold">(Hotfix — tezkor chiqaruv)</span>
        ) : (
          <span className="text-emerald-700 font-medium">(Standart reliz)</span>
        )}
      </span>
      <RenderBadge name="Preview" />
    </div>
  );
}

// ==========================================
// 4. Asosiy Production Form Komponenti
// ==========================================
export function ProductionReleaseForm() {
  // Accessibility uchun unikal ID'lar
  const nameId = useId();
  const nameErrId = useId();
  const tagId = useId();
  const tagErrId = useId();
  const notesId = useId();

  const {
    register,
    control,
    handleSubmit,
    setError,
    reset,
    formState: { errors, isSubmitting, isSubmitSuccessful },
  } = useForm<ProjectReleaseFormValues>({
    mode: "onBlur",
    reValidateMode: "onChange",
    shouldFocusError: true,
    defaultValues: DEFAULT_RELEASE_VALUES,
  });

  const onSubmit: SubmitHandler<ProjectReleaseFormValues> = async (values) => {
    const payload = toReleasePayload(values);

    try {
      // Simulyatsiya qilingan API so'rov
      console.log("Serverga jo'natilmoqda:", payload);
      await new Promise((resolve) => setTimeout(resolve, 800));

      reset(DEFAULT_RELEASE_VALUES);
      alert("Reliz muvaffaqiyatli chop etildi!");
    } catch (error) {
      if (axios.isAxiosError<ReleaseApiError>(error)) {
        mapReleaseServerErrors(error.response?.data, setError);
      } else {
        setError("root.serverError", {
          type: "unknown",
          message: "Tarmoq bilan aloqa uzildi. Iltimos, internetni tekshiring.",
        });
      }
    }
  };

  return (
    <div className="max-w-lg mx-auto p-6 bg-white rounded-xl shadow-lg space-y-6">
      <div className="flex items-center justify-between border-b pb-3">
        <div>
          <h2 className="text-xl font-bold text-gray-900">Yangi Relizni E'lon Qilish</h2>
          <p className="text-xs text-gray-500">Production muhandislik standartlariga muvofiq forma</p>
        </div>
        <RenderBadge name="Root Form" />
      </div>

      <form onSubmit={handleSubmit(onSubmit)} noValidate className="space-y-4">
        {/* Umumiy Server Xatosi */}
        {errors.root?.serverError && (
          <div
            role="alert"
            className="p-3 bg-rose-50 border border-rose-300 rounded-lg text-sm text-rose-700"
          >
            {errors.root.serverError.message}
          </div>
        )}

        {/* Muvaffaqiyat bildirishnomasi */}
        {isSubmitSuccessful && !errors.root?.serverError && (
          <div
            role="status"
            aria-live="polite"
            className="p-3 bg-emerald-50 border border-emerald-300 rounded-lg text-sm text-emerald-800"
          >
            ✓ Reliz muvaffaqiyatli yaratildi va e'lon qilindi.
          </div>
        )}

        {/* Loyiha Nomi */}
        <div>
          <label htmlFor={nameId} className="block text-sm font-medium text-gray-700 mb-1">
            Loyiha nomi *
          </label>
          <input
            id={nameId}
            disabled={isSubmitting}
            aria-invalid={Boolean(errors.projectName)}
            aria-describedby={errors.projectName ? nameErrId : undefined}
            {...register("projectName", {
              required: "Loyiha nomini kiritish majburiy",
              minLength: { value: 3, message: "Nom kamida 3 ta harfdan iborat bo'lsin" },
            })}
            placeholder="Masalan: FinTech_Mobile_App"
            className={`w-full px-3 py-2 border rounded-lg outline-none transition text-sm ${
              errors.projectName
                ? "border-rose-500 focus:ring-2 focus:ring-rose-200"
                : "border-gray-300 focus:ring-2 focus:ring-blue-200 focus:border-blue-500"
            } disabled:bg-gray-100 disabled:cursor-not-allowed`}
          />
          {errors.projectName && (
            <p id={nameErrId} role="alert" className="text-xs text-rose-600 mt-1 font-medium">
              {errors.projectName.message}
            </p>
          )}
        </div>

        {/* Versiya Tegi */}
        <div>
          <label htmlFor={tagId} className="block text-sm font-medium text-gray-700 mb-1">
            Versiya tegi *
          </label>
          <input
            id={tagId}
            disabled={isSubmitting}
            aria-invalid={Boolean(errors.versionTag)}
            aria-describedby={errors.versionTag ? tagErrId : undefined}
            {...register("versionTag", {
              required: "Versiya tegini kiritish shart",
              pattern: {
                value: /^v\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?$/,
                message: "Format: v1.0.0 yoki v2.1.0-beta",
              },
            })}
            placeholder="v1.2.0"
            className={`w-full px-3 py-2 border rounded-lg outline-none font-mono text-sm transition ${
              errors.versionTag
                ? "border-rose-500 focus:ring-2 focus:ring-rose-200"
                : "border-gray-300 focus:ring-2 focus:ring-blue-200 focus:border-blue-500"
            } disabled:bg-gray-100 disabled:cursor-not-allowed`}
          />
          {errors.versionTag && (
            <p id={tagErrId} role="alert" className="text-xs text-rose-600 mt-1 font-medium">
              {errors.versionTag.message}
            </p>
          )}
        </div>

        {/* Hotfix tanlash */}
        <label className="flex items-center gap-3 text-sm cursor-pointer select-none">
          <input
            type="checkbox"
            disabled={isSubmitting}
            {...register("isHotfix")}
            className="w-4 h-4 text-blue-600 rounded"
          />
          <span className="text-gray-700 font-medium">Ushbu reliz Hotfix (favqulodda tuzatish) hisoblanadi</span>
        </label>

        {/* Izolyatsiya qilingan preview nishoni */}
        <ReleaseBadgePreview control={control} />

        {/* O'zgarishlar Ro'yxati */}
        <div>
          <label htmlFor={notesId} className="block text-sm font-medium text-gray-700 mb-1">
            Changelog izohi (ixtiyoriy)
          </label>
          <textarea
            id={notesId}
            rows={3}
            disabled={isSubmitting}
            {...register("changelogNotes")}
            placeholder="Ushbu relizda amalga oshirilgan asosiy yangiliklar va tuzatishlar..."
            className="w-full px-3 py-2 border border-gray-300 rounded-lg outline-none focus:ring-2 focus:ring-blue-200 focus:border-blue-500 text-sm"
          />
        </div>

        {/* Tugmalar guruhi */}
        <div className="flex items-center gap-3 pt-2">
          <button
            type="submit"
            disabled={isSubmitting}
            className="flex-1 py-2.5 px-4 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-400 text-white font-medium rounded-lg transition"
          >
            {isSubmitting ? "Chop etilmoqda..." : "Relizni chop etish"}
          </button>

          <button
            type="button"
            disabled={isSubmitting}
            onClick={() => reset(DEFAULT_RELEASE_VALUES)}
            className="py-2.5 px-4 border border-gray-300 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-50 transition"
          >
            Tozalash
          </button>
        </div>
      </form>
    </div>
  );
}

4. Production Anti-Patternlar (Nimalardan aslo foydalanmaslik kerak?)

Xato amaliyot (Anti-pattern) Nima uchun xavfli? Standart yechim
useForm() tipsiz ishlatish data.emial kabi xatolarni TypeScript sezmaydi Har doim useForm<FormValues>()
Chala defaultValues berish uncontrolled to controlled warning'lari va isDirty xatolari Barcha maydonlar default qiymatga ega bo'lishi shart
Tugmaga type="button" bermaslik Modal ichidagi "Bekor qilish" tugmasi formani submit qilib yuboradi Submit bo'lmagan barcha tugmalarga type="button"
Xatoda darhol reset() qilish Foydalanuvchi kiritgan butun ma'lumot yo'qoladi va qattiq g'azablanadi Faqat 200 OK bo'lgandagina reset() qilish kerak
Ota formada watch() chaqirish Har bir harfda 50 ta komponent re-render bo'lib, telefon qizib ketadi Kichik komponentga chiqarib useWatch ishlatish

Xulosa

  • Muhandislik madaniyati: Production formasi shunchaki chiroyli inputlar emas, balki qat'iy tiplashtirilgan, a11y standartlariga javob beradigan, xavfsiz va 60 FPS tezlikda ishlovchi mustahkam tizimdir.
  • Ushbu 7 ta mezon va checklist real production loyihalarida texnik qarzlarning oldini olish va foydalanuvchilar uchun eng yaxshi tajribani ta'minlashning kafolatidir.