Seriya: TanStack Router Dars 58

SSR va SPA — TanStack Router'da rendering rejimlari

TanStack Router'da SPA va SSR arxitekturasi: TanStack Start, Hydration va Dehydration mexanizmi, qachon qaysi rejimni tanlash va React Router bilan taqqos.

58-dars

SSR va SPA — TanStack Router'da rendering rejimlari

Zamonaviy veb-dasturlashda ilovani qanday usulda foydalanuvchiga taqdim etish — loyihaning tezligi, qidiruv tizimlaridagi reytingi (SEO) va server xarajatlariga bevosita ta'sir ko‘rsatadi.

TanStack Router ham Single Page Application (SPA / CSR), ham Server-Side Rendering (SSR) arxitekturalarini teng darajada qo‘llab-quvvatlaydi.


1. Hayotiy o‘xshatish: IKEA mebellari va Tayyor yig‘ilgan mebel

Tasavvur qiling, siz yangi xonadoningizga oshxona mebelini buyurtma qildingiz:

  • SPA / Client-Side Rendering (IKEA usuli): Do‘kon sizning uyingizga bo‘sh quti, taxtalar, murvatlar va yo‘riqnomani olib keladi (Bo‘sh HTML va JavaScript bundle). Siz o‘z uyingizda o‘tirib, mebelni noldan o‘zingiz yig‘asiz (Mijoz brauzerida render bo‘ladi). Do‘kon egasiga juda oson va arzon, ammo mebel yig‘ilguncha siz bo‘sh xonada kutib turasiz.
  • SSR / Server-Side Rendering (Tayyor mebel): Do‘kon ustalari o‘z ustaxonasida mebelni to‘liq yig‘ib, uyingizga tayyor holatda olib kirib qo‘yishadi (Serverda to‘liq chizilgan HTML). Siz darhol stulga o‘tirishingiz mumkin (0 ms kutish). So‘ngra usta mebelga aqlli elektron tugmalarni ulab qo‘yadi (Hydration — sahifaga interaktivlik qo‘shiladi).

2. SPA (Single Page Application) rejimi

SPA rejimida brauzer serverdan dastlabki paytda deyarli bo‘sh HTML (<div id="root"></div>) va asosiy JavaScript faylini yuklab oladi.

Foydalanuvchi so'rovi ──> Bo'sh HTML + JS ──> Brauzerda Loader va Render ──> Tayyor UI

Afzalliklari:

  1. Statik Hosting arzonligi: Serverda Node.js ishlatish shart emas. Saytni Netlify, Vercel, GitHub Pages yoki oddiy CDN (Cloudflare) orqali arzon joylashtirish mumkin.
  2. Yashin tezligidagi navigatsiya: Sahifalar bir marta ochilgach, keyingi o‘tishlar mahalliy mobil ilovalardek bir zumda sodir bo‘ladi.
  3. Nol server yuklamasi: Barcha hisob-kitoblar va render qilish foydalanuvchining qurilmasida bajariladi.

Qachon tanlanadi?

Admin panellar, CRM tizimlar, SaaS ilovalar, shaxsiy kabinetlar — ya'ni tizimga faqat login qilib kiriladigan va SEO muhim bo‘lmagan barcha yopiq loyihalar uchun SPA eng yaxshi tanlovdir.


3. SSR (Server-Side Rendering) rejimi va TanStack Start

SSR rejimida foydalanuvchi sahifaga kirganda so‘rov serverga (Node.js, Bun yoki Edge Worker) boradi. Server beforeLoad va loader funksiyalarini bajarib, barcha ma'lumotlarni tortadi, React komponentlarini to‘liq HTML ko‘rinishiga aylantirib, brauzerga tayyor holda jo‘natadi.

TanStack Router SSR imkoniyatlarini to‘liq ochib berish uchun TanStack Start nomli zamonaviy full-stack freymvorkni taqdim etadi:

// Server tomonlama render qilish (SSR Entry)
import { createMemoryHistory } from '@tanstack/react-router'
import { StartServer } from '@tanstack/start/server'
import { createRouter } from './router'

export default async function render(request: Request) {
  const router = createRouter()

  // 1. Serverga kelgan URL'ni MemoryHistory orqali routerga biriktiramiz
  router.update({
    history: createMemoryHistory({
      initialEntries: [request.url],
    }),
  })

  // 2. Barcha loader'lar serverda to'liq bajarilishini kutamiz
  await router.load()

  // 3. To'liq ma'lumotli HTML'ni generatsiya qilamiz
  return <StartServer router={router} />
}

4. Dehydration va Hydration: Qayta yuklashning oldini olish

SSR arxitekturasida eng katta xavf — Double-Fetching (server ma'lumotni yukladi, brauzerga kelgach yana qaytadan yuklashi).

TanStack Router buni aqlli Hydration orqali hal qiladi:

  1. Dehydration (Serverda): Serverda yuklangan loader ma'lumotlari maxsus JSON ko‘rinishida HTML skriptiga qadoqlanadi.
  2. Hydration (Brauzerda): Brauzer ishga tushganda, router o‘sha JSON ma'lumotlarini to‘g‘ridan-to‘g‘ri o‘z keshiga o‘qiydi. Natijada brauzer server qilgan ishni qayta takrorlamaydi!

5. Rendering rejimlarining solishtirma oqimi (Mermaid Diagram)

flowchart TD
    subgraph SPA["SPA / CSR Rejimi"]
        direction TB
        S1["1. Foydalanuvchi saytga kirdi"] --> S2["2. Bo'sh HTML yuklanadi (Oq ekran)"]
        S2 --> S3["3. JS yuklanadi va brauzerda loader() ishlaydi"]
        S3 --> S4["4. Nihoyat UI chiziladi (Kutish vaqti katta)"]
    end

    subgraph SSR["SSR Rejimi (TanStack Start)"]
        direction TB
        R1["1. Foydalanuvchi saytga kirdi"] --> R2["2. Server loader() ni bajarib, tayyor HTML yasaydi"]
        R2 --> R3["3. Brauzer tayyor matn va rasmlarni darhol ko'rsatadi (0 ms)"]
        R3 --> R4["4. Hydration: React sahifaga 'jon' bag'ishlaydi (Interaktiv)"]
    end

6. Qaysi rejimni tanlash kerak? (Qiyosiy Jadval)

Mezon SPA (Client-Side Rendering) SSR (TanStack Start / Server-Side)
SEO (Qidiruv tizimlari) ⚠️ Cheklangan (botlar JS kutishi kerak) ✅ Mukammal (HTML boshidanoq tayyor)
Birinchi ochilish tezligi (FCP) Sekinroq (katta JS yuklanishini kutadi) Zudlik bilan (Tayyor HTML ochiladi)
Server xarajatlari Juda arzon / Bepul (Statik CDN) Node/Edge server resurslari talab etiladi
Ilova turi Admin panellar, Dashboard, CRM Do‘konlar (E-commerce), Bloglar, Yangiliklar
Joylashtirish (Deploy) GitHub Pages, S3, Netlify Vercel, Cloudflare Workers, Node VPS

Xulosa

  • SPA (Single Page Application) — barcha yuklash va chizish jarayonlarini foydalanuvchi brauzerida bajaruvchi tezkor va arzon rejim.
  • SSR (Server-Side Rendering) — serverda to‘liq ma'lumotli HTML hosil qilib beruvchi, SEO va birinchi yuklanish tezligi uchun muhim arxitektura.
  • TanStack Router ikkala rejimda ham bir xil type-safe loader va beforeLoad tizimidan foydalanadi.
  • TanStack Start orqali server render, avtomatik gidratsiya va to‘liq full-stack imkoniyatlari taqdim etiladi.