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:
- Statik Hosting arzonligi: Serverda Node.js ishlatish shart emas. Saytni Netlify, Vercel, GitHub Pages yoki oddiy CDN (Cloudflare) orqali arzon joylashtirish mumkin.
- Yashin tezligidagi navigatsiya: Sahifalar bir marta ochilgach, keyingi o‘tishlar mahalliy mobil ilovalardek bir zumda sodir bo‘ladi.
- 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:
- Dehydration (Serverda): Serverda yuklangan
loaderma'lumotlari maxsus JSON ko‘rinishida HTML skriptiga qadoqlanadi. - 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
loadervabeforeLoadtizimidan foydalanadi. - TanStack Start orqali server render, avtomatik gidratsiya va to‘liq full-stack imkoniyatlari taqdim etiladi.