Series: React Hook Form Lesson 88

Optimistic Form Submission — Optimistic update yondashuvi

Server javobini kutmasdan UI ni yangilash, snapshot va rollback mexanizmi, vaqtinchalik ID lar, xatoliklarni qayta tiklash va TanStack Query integratsiyasi.

88-dars

Optimistic Form Submission — Optimistic update yondashuvi

Optimistic Form Submission (optimistik yangilanish yondashuvi) — bu form yuborilganda serverning javobini (200 OK) kutib o'tirmasdan, interfeysdagi ro'yxat, karta yoki sozlamalarni bir zumda yangilab ko'rsatish, agar so'rov kutilmaganda xatolik bilan tugasa (catch), interfeysni avvalgi holatiga qaytarish (Rollback) va foydalanuvchiga xabar berish usulidir.

Zamonaviy tezkor ilovalarda (Telegram, Linear, Notion, GitHub) foydalanuvchi har bir izoh, status yoki reaksiyadan keyin kutish indikatorini (spinner) ko'rmaydi — barcha amallar darhol ekranda aks etadi.


1. Optimistic Update qanday ishlaydi?

graph TD
  A["Foydalanuvchi Submit bosadi"] --> B["1. Snapshot: Eski holat nusxasi olinadi"]
  B --> C["2. Vaqtinchalik (tempId) element ro'yxatga qo'shiladi va forma tozalanadi"]
  C --> D["3. Serverga so'rov jo'natiladi (axios.post)"]
  D -->|Muvaffaqiyatli (200 OK)| E["tempId haqiqiy server ID si bilan almashtiriladi (pending: false)"]
  D -->|Xatolik (Network / Server Error)| F["4. Rollback: Eski snapshot holati tiklanadi va xato ko'rsatiladi"]
  1. Snapshot (Nusxa olish): So'rov ketishidan oldin joriy ma'lumotlar holati o'zgaruvchida saqlanadi.
  2. Optimistic UI & Reset: Server javobini kutmasdan vaqtinchalik ID (temp-${Date.now()}) bilan yangi element ro'yxatga kiritiladi, formaning inputlari esa yangi ma'lumot kiritish uchun zudlik bilan tozalanadi (reset()).
  3. Asinxron API chaqiruvi: Serverga haqiqiy HTTP so'rovi jo'natiladi.
  4. Muvaffaqiyat: Serverdan haqiqiy ob'ekt qaytgach, vaqtinchalik element haqiqiy ma'lumotga almashtiriladi (pending: false).
  5. Rollback (Ortga qaytarish): Agar tarmoq uzilsa yoki server xato bersa, UI eski snapshot holatiga qaytariladi va setError("root.optimisticError") orqali ogohlantirish beriladi.

2. Qachon qo'llash mos va qachon mumkin emas?

Mos holatlar (Tavsiya etiladi) Xavfli holatlar (Qat'iyan tavsiya etilmaydi)
Izohlar va xabarlar: Post ostiga tezkor izoh qo'shish. To'lovlar va bank o'tkazmalari: Tranzaksiyalar aniq server tasdig'ini kutishi shart.
Status o'zgartirish: Vazifani "Bajarildi" qilish yoki Like bosish. Xavfsizlik va parollar: Parol o'zgartirish yoki 2FA yoqish.
Tezkor eslatmalar / Todo: Shaxsiy vazifalar ro'yxatini yaratish. Huquq va rollar (RBAC): Foydalanuvchiga Admin ruxsati berish.

3. Real misol: Optimistic izoh qo'shish va Rollback mexanizmi

Quyidagi misolda yangi izoh yozilishi bilan darhol ekranda "Saqlanmoqda..." ko'rinishida paydo bo'ladi. Agar so'rov muvaffaqiyatsiz bo'lsa, izoh ro'yxatdan olib tashlanadi (Rollback) va forma qizil xato xabarini chiqaradi:

import React, { useState } from "react";
import axios from "axios";
import { useForm, type SubmitHandler } from "react-hook-form";

// 1. Izoh elementi strukturasi
type CommentItem = {
  id: string;
  author: string;
  body: string;
  pending?: boolean; // Vaqtinchalik optimistik holat bayrog'i
};

// 2. Forma qiymatlari tipi
type CommentFormValues = {
  author: string;
  body: string;
};

export function OptimisticCommentForm() {
  // Mavjud izohlar ro'yxati
  const [comments, setComments] = useState<CommentItem[]>([
    {
      id: "1",
      author: "Ali Valiyev",
      body: "TanStack Router va React Hook Form birikmasi loyihada juda qulay ishlayapti.",
    },
  ]);

  const {
    register,
    handleSubmit,
    reset,
    setError,
    clearErrors,
    formState: { errors },
  } = useForm<CommentFormValues>({
    defaultValues: {
      author: "",
      body: "",
    },
  });

  const onSubmit: SubmitHandler<CommentFormValues> = async (values) => {
    clearErrors("root.optimisticError");

    // 1. SNAPSHOT: Xatolik yuz berganda qaytarish uchun joriy holat nusxasi
    const previousComments = [...comments];
    const tempId = `temp-${Date.now()}`;

    // Vaqtinchalik optimistik izoh ob'ekti
    const optimisticComment: CommentItem = {
      id: tempId,
      author: values.author.trim(),
      body: values.body.trim(),
      pending: true,
    };

    // 2. OPTIMISTIC UPDATE: Serverni kutmasdan UI'ni darhol yangilaymiz va formani tozalaymiz
    setComments((prev) => [optimisticComment, ...prev]);
    reset({ author: values.author, body: "" });

    try {
      // 3. Serverga haqiqiy asinxron POST so'rovi
      const { data: savedComment } = await axios.post<CommentItem>(
        "/api/comments",
        {
          author: optimisticComment.author,
          body: optimisticComment.body,
        }
      );

      // Muvaffaqiyatli yakun: temp elementni serverdan qaytgan haqiqiy ob'ektga almashtiramiz
      setComments((prev) =>
        prev.map((item) =>
          item.id === tempId ? { ...savedComment, pending: false } : item
        )
      );
    } catch (error) {
      // 4. ROLLBACK: Server xato berganda ro'yxatni avvalgi holatiga qaytaramiz
      setComments(previousComments);

      const errorMessage = axios.isAxiosError<{ message?: string }>(error)
        ? error.response?.data?.message || "Izohni saqlab bo'lmadi. Holat avvalgi ko'rinishga qaytarildi."
        : "Tarmoq bilan aloqa uzildi. Kiritilgan izoh bekor qilindi.";

      setError("root.optimisticError", {
        type: "server",
        message: errorMessage,
      });
    }
  };

  return (
    <div style={{ maxWidth: "520px", display: "flex", flexDirection: "column", gap: "16px" }}>
      <h3 style={{ margin: 0 }}>Izoh qoldirish (Optimistic)</h3>

      <form onSubmit={handleSubmit(onSubmit)} noValidate style={{ display: "flex", flexDirection: "column", gap: "12px" }}>
        {/* Rollback xatosi xabarnomasi */}
        {errors.root?.optimisticError && (
          <div
            role="alert"
            style={{
              padding: "10px 14px",
              background: "#fef2f2",
              border: "1px solid #f87171",
              borderRadius: "6px",
              color: "#b91c1c",
              fontSize: "13px",
            }}
          >
            {errors.root.optimisticError.message}
          </div>
        )}

        {/* Ism maydoni */}
        <div>
          <label htmlFor="author" style={{ display: "block", fontSize: "13px", fontWeight: 600, marginBottom: "4px" }}>
            Ismingiz *
          </label>
          <input
            id="author"
            {...register("author", { required: "Ism kiritilishi shart" })}
            placeholder="Masalan: Muhammadjon"
            style={{ width: "100%", padding: "7px 10px", boxSizing: "border-box" }}
            aria-invalid={Boolean(errors.author)}
          />
          {errors.author && (
            <p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "2px" }}>
              {errors.author.message}
            </p>
          )}
        </div>

        {/* Izoh matni */}
        <div>
          <label htmlFor="body" style={{ display: "block", fontSize: "13px", fontWeight: 600, marginBottom: "4px" }}>
            Izoh matni *
          </label>
          <textarea
            id="body"
            {...register("body", { required: "Izoh matnini kiriting" })}
            rows={2}
            placeholder="Fikringizni bildiring..."
            style={{ width: "100%", padding: "7px 10px", boxSizing: "border-box" }}
            aria-invalid={Boolean(errors.body)}
          />
          {errors.body && (
            <p role="alert" style={{ color: "#e11d48", fontSize: "12px", marginTop: "2px" }}>
              {errors.body.message}
            </p>
          )}
        </div>

        <button
          type="submit"
          style={{
            alignSelf: "flex-start",
            padding: "8px 18px",
            background: "#2563eb",
            color: "#fff",
            border: "none",
            borderRadius: "6px",
            cursor: "pointer",
            fontWeight: 600,
          }}
        >
          Izoh qoldirish
        </button>
      </form>

      {/* Izohlar ro'yxati */}
      <div style={{ display: "flex", flexDirection: "column", gap: "10px", borderTop: "1px solid #e2e8f0", paddingTop: "14px" }}>
        <h4 style={{ margin: 0, fontSize: "14px" }}>Mavjud fikrlar ({comments.length}):</h4>

        {comments.map((comment) => (
          <div
            key={comment.id}
            style={{
              padding: "10px 12px",
              background: comment.pending ? "#f8fafc" : "#ffffff",
              border: comment.pending ? "1px dashed #cbd5e1" : "1px solid #e2e8f0",
              borderRadius: "6px",
              opacity: comment.pending ? 0.75 : 1,
            }}
          >
            <div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: "4px" }}>
              <strong style={{ fontSize: "13px" }}>{comment.author}</strong>
              {comment.pending && (
                <span style={{ fontSize: "11px", color: "#64748b", fontStyle: "italic" }}>
                  ⏳ Saqlanmoqda...
                </span>
              )}
            </div>
            <p style={{ margin: 0, fontSize: "13px", color: "#334155" }}>{comment.body}</p>
          </div>
        ))}
      </div>
    </div>
  );
}

4. TanStack Query bilan optimistik boshqaruv

Agar loyihada ma'lumotlar almashinuvi TanStack Query (@tanstack/react-query) orqali amalga oshirilsa, useMutation hooki optimistic update va rollback jarayonini kesh darajasida avtomatlashtiradi:

const queryClient = useQueryClient();

const { mutate } = useMutation({
  mutationFn: (newComment: CommentFormValues) => axios.post("/api/comments", newComment),
  onMutate: async (newComment) => {
    // 1. Keshdagi faol so'rovlarni to'xtatib turamiz
    await queryClient.cancelQueries({ queryKey: ["comments"] });
    // 2. Snapshot olamiz
    const previousComments = queryClient.getQueryData(["comments"]);
    // 3. Keshni optimistik yangilaymiz
    queryClient.setQueryData(["comments"], (old: CommentItem[] = []) => [
      { id: Date.now().toString(), ...newComment, pending: true },
      ...old,
    ]);
    return { previousComments };
  },
  onError: (err, newComment, context) => {
    // 4. Xatolikda keshni avvalgi snapshotga qaytaramiz (Rollback)
    queryClient.setQueryData(["comments"], context?.previousComments);
  },
  onSettled: () => {
    // 5. Serverdagi haqiqiy ma'lumotlar bilan keshni qayta sinxronlaymiz
    queryClient.invalidateQueries({ queryKey: ["comments"] });
  },
});

5. Xulosa va tavsiyalar

  1. Tezkorlik (Instant Feel): Optimistic update foydalanuvchiga interfeysni judayam tez va zamonaviy his qildiradi.
  2. Rollback shart: Har doim try/catch yoki onError da avvalgi snapshotni tiklash mexanizmini to'g'ri qo'llang, aks holda foydalanuvchi saqlanmagan xato ma'lumotni saqlangan deb o'ylashi mumkin.
  3. Kritik amallardan qoching: Moliyaviy va xavfsizlikka oid tranzaksiyalarda optimistik emas, an'anaviy isSubmitting kutish rejimini tanlang.