Seriya: TanStack Router Dars 24

Route matching — Route pattern va matching jarayoni

TanStack Router'da Route Matching mexanizmi: URL segmentatsiyasi, Specificity Ranking (statik vs dinamik ustunlik), matches zanjiri va React Router bilan taqqoslash.

24-dars

Route matching — Route pattern va matching jarayoni

Tasavvur qiling, siz xalqaro avtomatlashtirilgan pochta saralash markazida turibsiz. Konveyer lentasida millionlab xatlar va posilkalar oqib keladi. Har bir jo‘natma ustida manzil yozilgan: "Toshkent shahri, Yunusobod tumani, 12-uy". Skaner avval eng katta manzilni (shahar — __root), so‘ng tumanni (ota layout — /yunusobod), so‘ngra aniq xonadonni (bola sahifa — /12) bosqichma-bosqich aniqlab, xatni to‘g‘ri qutiga tashlaydi. Agar xat ustiga "Yunusobod tumanidagi Bosh Pochta binosi" deb aniq nom (statik manzil) yozilgan bo‘lsa, tizim uni adashib oddiy uylar (dinamik $houseId) qutisiga yubormaydi.

TanStack Router’dagi Route Matching jarayoni aynan shu aqlli saralash skaneri kabi ishlaydi. U brauzerdagi URL manzilni siz tuzgan Route Tree bilan solishtirib, eng aniq va to‘g‘ri sahifalar zanjirini topib beradi.


1. Matching jarayonining 4 bosqichi

Foydalanuvchi biror manzilga (masalan, /posts/42/comments) o‘tganda, TanStack Router ichki arxitekturada quyidagi 4 qadamni amalga oshiradi:

  1. Segmentlarga ajratish (URL Parsing): URL qismlarga bo‘lib olinadi: ['posts', '42', 'comments'].
  2. Daraxt bo‘ylab chuqurlashish (Tree Traversal): Router eng yuqori ildizdan (__root.tsx) boshlab pastga qarab mos marshrutlarni izlaydi.
  3. Shablonlarni solishtirish (Pattern Matching): Har bir segment statik matn (posts), dinamik parametr ($postId) yoki catch-all ($) shablonlariga solishtiriladi.
  4. Matches zanjirini yig‘ish (Matches Array): Mos kelgan barcha ota va bola marshrutlar bitta tartibli massivga (matches) yig‘iladi: [RootRoute, PostsRoute, PostDetailRoute, CommentsRoute].
flowchart TD
    URL["URL: /posts/42/comments"] --> Parse["1. Segmentlarga bo'lish: ['posts', '42', 'comments']"]
    Parse --> Root["2. __root.tsx (Ildiz layout mos keldi)"]
    Root --> Posts["3. src/routes/posts.tsx (Ota bo'lim)"]
    Posts --> PostId["4. src/routes/posts/$postId.tsx (ID = '42')"]
    PostId --> Comments["5. src/routes/posts/$postId/comments.tsx"]
    Comments --> Matches["6. Matches zanjiri tayyor bo'ldi va render boshlanadi"]

2. Specificity Ranking — Statik va Dinamik marshrutlar to'qnashuvi

Real loyihalarda quyidagi kabi bir-biriga juda o‘xshash ikkita marshrut bo‘lishi tabiiy:

  • src/routes/posts/new.tsx $\to$ /posts/new (Yangi post yaratish sahifasi — Statik)
  • src/routes/posts/$postId.tsx $\to$ /posts/:postId (Bitta post tafsiloti — Dinamik)

Foydalanuvchi brauzerda /posts/new deb yozsa, router qaysi birini ochadi? Axir $postId o‘zgaruvchisi o‘rniga "new" so‘zi ham bemalol tushishi mumkin-ku!

Ustuvorlik qoidasi:

TanStack Router Specificity Ranking (aniqlik darajasi) algoritmidan foydalanadi:

[!IMPORTANT] Statik yo‘llar har doim dinamik yo‘llardan ustun turadi!

  1. Statik segmentlar (/new, /about) — Eng yuqori prioritet.
  2. Dinamik parametrlar (/$postId, /$slug) — O‘rta prioritet.
  3. Catch-all / Splat segmentlar (/$, /*) — Eng past prioritet.

Shu sababli, foydalanuvchi /posts/new manziliga kirganda, router avval to‘liq mos keluvchi statik new.tsx faylini ochadi. Agar /posts/105 deb yozilsa, statik moslik topilmaydi va router keyingi prioritetdagi $postId.tsx fayliga o‘tadi.

Siz fayllarni qaysi tartibda yaratganingizdan qat'i nazar, Vite plagini Route Tree’ni avtomatik ravishda to‘g‘ri prioritetda saralab beradi.


3. Real vaqtda matches zanjirini kuzatish

Ilovaning istalgan joyida joriy URL manzilga qaysi marshrutlar zanjiri mos kelganini ko‘rish uchun useRouterState ichidagi matches massividan foydalanamiz:

import { useRouterState } from '@tanstack/react-router'

export function RouteDebugInspector() {
  // Joriy sahifaga mos kelgan barcha ota va bola marshrutlarni olamiz
  const matches = useRouterState({
    select: (state) => state.matches,
  })

  return (
    <div style={{ padding: '1rem', background: '#0f172a', color: '#f8fafc', borderRadius: '8px' }}>
      <h4>Faol marshrutlar zanjiri ({matches.length} ta):</h4>
      <ul style={{ paddingLeft: '1.2rem', fontFamily: 'monospace' }}>
        {matches.map((match) => (
          <li key={match.id} style={{ margin: '0.25rem 0' }}>
            <strong>{match.routeId}</strong> &mdash; Path: <code>{match.pathname}</code>
          </li>
        ))}
      </ul>
    </div>
  )
}

[!TIP] Har bir match obyekti ichida o‘sha route uchun yuklangan ma'lumotlar (loaderData), xatoliklar (error) va parametrlar (params) jamlangan bo‘ladi.


4. Statik vs Dinamik tahlili (Mermaid Diagram)

flowchart TD
    Request["Foydalanuvchi kirdi: /posts/new"] --> CheckStatic{"Statik moslik bormi: /posts/new?"}
    
    CheckStatic -- "Ha (Topildi)" --> ServeStatic["src/routes/posts/new.tsx ochiladi (1-darajali ustunlik)"]
    CheckStatic -- "Yo'q" --> CheckDynamic{"Dinamik moslik bormi: /posts/$postId?"}
    
    CheckDynamic -- "Ha (Masalan /posts/42)" --> ServeDynamic["src/routes/posts/$postId.tsx ochiladi (2-darajali ustunlik)"]
    CheckDynamic -- "Yo'q" --> NotFound["Catch-all ($.tsx) yoki 404 sahifa (3-darajali ustunlik)"]

5. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router
Moslikni qidirish URL score tizimi orqali Ierarxik Route Tree va AST saralash orqali
Statik vs Dinamik ustunlik Maxsus hisoblash ballari asosida Doimo statik yo‘llar ustun (Deterministik)
Tartibga bog‘liqlik Massivdagi o‘rin ba'zida natijaga ta'sir qilishi mumkin Fayl yaratilish tartibiga umuman bog‘liq emas
matches inspeksiyasi useMatches() orqali cheklangan ma'lumot state.matches orqali to‘liq va type-safe ma'lumot

Xulosa

  • Route Matching — brauzerdagi URL va ilovaning Route Tree tuzilmasi o‘rtasidagi moslikni aniqlash jarayonidir.
  • TanStack Router doimo Specificity Ranking qoidasiga amal qiladi: Statik marshrutlar har doim Dinamik marshrutlardan yuqori prioritetga ega.
  • state.matches massivi orqali ayni paytda ekranni tashkil etib turgan barcha ota-bola marshrutlar zanjirini tahlil qilish mumkin.