Seriya: TanStack Router Dars 61

Mutation va navigation — Mutation'dan keyin redirect yoki invalidate

TanStack Router'da mutatsiyadan keyingi harakatlar: router.invalidate(), keshni tozalash, navigatsiya, TanStack Query (useMutation) bilan integratsiya va React Router bilan taqqos.

61-dars

Mutation va navigation — Mutation'dan keyin redirect yoki invalidate

Oldingi darslarda bilib olganimizdek, TanStack Router ma'lumotlarni o‘zining ichki keshida (In-Memory Cache) saqlaydi.

Lekin tasavvur qiling: foydalanuvchi maqolani tahrirladi (PUT), yangi sarlavha kiritdi va "Saqlash" tugmasini bosdi. Serverdagi ma'lumotlar bazasi yangilandi, ammo agar biz keshni yangilamasdan post tafsilotlari sahifasiga o‘tib ketsak (navigate), router o‘z keshidagi eski postni ko‘rsatib qo‘yishi mumkin!

Buning oldini olish uchun TanStack Router’da mutatsiyadan keyin ikkita asosiy vazifa bajariladi:

  1. Keshni eskirgan deb belgilash (router.invalidate()).
  2. Foydalanuvchini kerakli manzilga yo‘naltirish (navigate()).

1. Hayotiy o‘xshatish: Haydovchilik guvohnomasini yangilash

Tasavvur qiling, siz Davlat xizmatlari markazida haydovchilik guvohnomangizni yangilamoqchisiz:

  • Eski usul (Kesh yangilanmaganda): Siz to‘lov qilib, yangi guvohnomani rasmiylashtirdingiz (Mutatsiya). Ammo inspektor yo‘l harakati ma'lumotlar bazasini yangilash tugmasini bosmadi (Invalidation qilinmadi). Ertasi kuni yo‘l politsiyasi planshetidan tekshirsa, keshda hali ham eski guvohnomangiz muddati o‘tgan bo‘lib ko‘rinadi.
  • router.invalidate() usuli: Yangi guvohnoma rasmiylashtirilgan ondayoq tizimdagi barcha terminallar va planshetlardagi eski yozuvlar bekor qilinadi. Siz markazdan chiqib ketayotganingizda (navigate), barcha tizimlar sizning yangi hujjatingizni 100% yangilangan holda ko‘radi.

2. Real Loyiha Misoli: Tahrirlash, Invalidate va Redirect

Quyidagi misolda post tahrirlangandan so‘ng keshni qanday yangilash va tafsilot sahifasiga qaytish ko‘rsatilgan:

// src/routes/posts/$postId/edit.tsx
import { createFileRoute, useNavigate, useRouter } from '@tanstack/react-router'
import { useState } from 'react'

export const Route = createFileRoute('/posts/$postId/edit')({
  loader: async ({ params, abortSignal }) => {
    const res = await fetch(`https://api.example.com/posts/${params.postId}`, {
      signal: abortSignal,
    })
    return res.json()
  },
  component: EditPostPage,
})

function EditPostPage() {
  const post = Route.useLoaderData()
  const { postId } = Route.useParams()
  const navigate = useNavigate()
  const router = useRouter() // 1. Router instansiyasini olamiz

  const [title, setTitle] = useState(post.title)
  const [isSaving, setIsSaving] = useState(false)

  const handleUpdate = async (e: React.FormEvent) => {
    e.preventDefault()
    setIsSaving(true)

    try {
      // 2. Serverga o'zgartirish so'rovini yuboramiz (Mutation)
      const res = await fetch(`https://api.example.com/posts/${postId}`, {
        method: 'PUT',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ title }),
      })

      if (!res.ok) throw new Error('O‘zgartirishni saqlab bo‘lmadi')

      // 3. KESHNI INVALIDATSIYA QILISH:
      // Router barcha faol route loader'larini qaytadan ma'lumot yuklashga majbur qiladi
      await router.invalidate()

      // 4. Tafsilot sahifasiga yo'naltiramiz
      navigate({
        to: '/posts/$postId',
        params: { postId },
      })
    } catch (error) {
      alert('Xatolik yuz berdi!')
    } finally {
      setIsSaving(false)
    }
  }

  return (
    <form onSubmit={handleUpdate} className="edit-form">
      <h2>Postni tahrirlash (ID: {postId})</h2>
      <input
        type="text"
        value={title}
        onChange={(e) => setTitle(e.target.value)}
        required
      />
      <button type="submit" disabled={isSaving}>
        {isSaving ? 'Saqlanmoqda...' : 'Saqlash va Chiqish'}
      </button>
    </form>
  )
}

3. router.invalidate() kapoti ostida nima sodir bo'ladi?

router.invalidate() chaqirilganda:

  1. Stale belgisi qo‘yiladi: Router keshdagi barcha faol marshrutlarning ma'lumotlarini eskirgan (stale) deb belgilaydi.
  2. Parallel qayta yuklash (Re-fetch): Agar foydalanuvchi ko‘rib turgan sahifada ota va bola marshrutlar bo‘lsa, ularning barcha loader funksiyalari darhol fonda qaytadan ishga tushadi.
  3. Promise yakunlanishi: Yangi ma'lumotlar kelishi bilan ekran sezdirmasdan yangilanadi va await router.invalidate() o‘z ishini muvaffaqiyatli tugatadi.

4. TanStack Query (useMutation) bilan birgalikda ishlash

Agar loyihangizda TanStack Query (React Query) o‘rnatilgan bo‘lsa, mutatsiyalarni boshqarish yanada professional ko‘rinishga keladi:

import { useMutation, useQueryClient } from '@tanstack/react-query'
import { useNavigate, useRouter } from '@tanstack/react-router'

function useUpdatePost() {
  const queryClient = useQueryClient()
  const router = useRouter()
  const navigate = useNavigate()

  return useMutation({
    mutationFn: (updatedPost: { id: string; title: string }) =>
      fetch(`/api/posts/${updatedPost.id}`, {
        method: 'PUT',
        body: JSON.stringify(updatedPost),
      }),

    onSuccess: async (_, variables) => {
      // 1. TanStack Query keshini tozalaymiz
      await queryClient.invalidateQueries({ queryKey: ['posts', variables.id] })

      // 2. TanStack Router keshini tozalaymiz
      await router.invalidate()

      // 3. Foydalanuvchini yo'naltiramiz
      navigate({ to: '/posts/$postId', params: { postId: variables.id } })
    },
  })
}

5. Mutatsiya va Navigatsiya oqimi (Mermaid Diagram)

sequenceDiagram
    autonumber
    actor User as Foydalanuvchi
    participant EditUI as /edit Formasi
    participant Server as Backend API
    participant Router as TanStack Router
    participant ViewUI as /posts/$postId Sahifasi

    User->>EditUI: 'Saqlash' tugmasini bosdi
    EditUI->>Server: PUT /posts/42 (Yangi ma'lumot)
    Server-->>EditUI: 200 OK (Muvaffaqiyatli yangilandi)
    
    EditUI->>Router: await router.invalidate()
    Router->>Router: Barcha faol keshlar eskirgan deb topildi
    
    EditUI->>Router: navigate({ to: '/posts/42' })
    Router->>ViewUI: Yangi ma'lumot bilan tafsilot sahifasi ochildi!
    ViewUI-->>User: Foydalanuvchi o'zi kiritgan yangi sarlavhani ko'radi (0 xato!)

6. React Router va TanStack Router taqqosi

Xususiyat React Router (useRevalidator) TanStack Router (router.invalidate)
Keshni yangilash mexanizmi revalidate() (cheklangan va faqat o‘zining loaderlarida) router.invalidate() (to‘liq va nozik kesh tizimi bilan integratsiyalashgan)
Asinxron kutish revalidate() promise qaytarmaydi await router.invalidate() yangilanish tugashini kutadi
TanStack Query sinergiyasi Qo‘lda bir-biriga moslashtirish kerak Bir xil mualliflar ekotizimi — mukammal bog‘lanadi
Navigatsiya bilan bog‘liqlik Ko‘pincha eski kesh miltillab ketadi Eski kesh miltillashisiz silliq o‘tish kafolatlanadi

Xulosa

  • Serverdagi ma'lumotlar o‘zgarganda (PUT/POST/DELETE) brauzer keshidagi eski ma'lumotlarni albatta yangilash talab etiladi.
  • router.invalidate() barcha faol marshrutlarning loaderlarini yangi ma'lumotni qayta yuklashga majbur qiladi.
  • Mutatsiya muvaffaqiyatli yakunlangach, await router.invalidate() va navigate({ to: ... }) ketma-ketligi orqali yangi sahifaga silliq o‘tiladi.
  • Bu yondashuv foydalanuvchiga har doim eng so‘nggi, haqqoniy ma'lumotlarni ko‘rsatishni kafolatlaydi.