Seriya: TanStack Router Dars 25

Route ranking — Mos route'lar orasidan keraklisini aniqlash

TanStack Router'da Route Ranking: marshrutlar to'qnashuvini hal qilish, ustuvorlik ierarxiyasi (Statik > Dinamik > Splat), komplyatsiya vaqtidagi saralash va React Router bilan taqqos.

25-dars

Route ranking — Mos route'lar orasidan keraklisini aniqlash

Tasavvur qiling, shahar yo‘l harakati qoidalarida "Barcha avtomobillar uchun tezlik soatiga 60 km" degan umumiy qoida bor (Dinamik shablon — $id). Biroq aynan shu chorrahada "Tez yordam va o‘t o‘chiruvchi mashinalar uchun harakat erkin" degan aniqroq maxsus belgi osilgan (Statik qoida — /new).

Chorrahaga tez yordam mashinasi kirib kelganda, nazoratchi hech ikkilanmasdan maxsus belgiga amal qiladi. Huquqshunoslikda bu qoida mashhur tamoyilga tayanadi: "Maxsus norma umumiy normadan har doim ustun turadi" (Lex specialis derogat legi generali).

Veb-ilovalarda ham aynan shunday vaziyat yuz beradi: bir nechta marshrutlar ayni bir xil URL manziliga da'vogarlik qilishi mumkin. TanStack Router’dagi Route Ranking (Ustuvorlik tizimi) qaysi marshrut eng aniq va to‘g‘ri ekanini matematik aniqlikda belgilab beradi.


1. Kolliziya (To'qnashuv) muammosi nimada?

Real loyihalarda postlar bo‘limini olaylik:

src/routes/
└── posts/
    ├── new.tsx        -> URL: "/posts/new" (Yangi post qo'shish formasi)
    └── $postId.tsx    -> URL: "/posts/:postId" (Post tafsilotlari)

Foydalanuvchi brauzerda /posts/new manziliga kirdi.

Agar routerda maxsus ranking tizimi bo‘lmasa, u "new" so‘zini $postId o‘rniga tushgan parametr deb tushunishi va adashib posts/$postId.tsx faylini ochib yuborishi mumkin edi. Natijada loader serverdan ID raqami "new" bo‘lgan maqolani qidirib, xatolik (404 Not Found) berardi!

Ammo TanStack Router’da Route Ranking tufayli bunday adashish mutlaqo yuz bermaydi.


2. TanStack Router’dagi ustuvorlik ierarxiyasi (Specificity Hierarchy)

TanStack Router barcha marshrutlarni ularning aniqlik darajasiga (Specificity Score) qarab avtomatik tartiblaydi:

flowchart TD
    subgraph Specificity["Ustuvorlik Ierarxiyasi (Yuqoridan pastga)"]
        Level1["1. Statik Segmentlar (/posts/new, /users/settings) — ENG YUQORI"]
        Level2["2. Dinamik Parametrlar (/posts/$postId, /users/$userId) — O'RTA"]
        Level3["3. Catch-all / Splat Segmentlar (/posts/$, /*) — ENG PAST (ZAXIRA)"]
    end

    Level1 --> Level2
    Level2 --> Level3

    style Level1 fill:#dcfce7,stroke:#16a34a,stroke-width:2px
    style Level2 fill:#fef9c3,stroke:#ca8a04,stroke-width:2px
    style Level3 fill:#fee2e2,stroke:#dc2626,stroke-width:2px

Ko'p segmentli URL'lar qanday solishtiriladi?

Agar bir nechta murakkab yo‘llar to‘qnashsa, har bir statik segment qo‘shimcha ball oladi:

  1. /posts/archive/2026 $\to$ 3 ta statik segment (Eng yuqori ustuvorlik)
  2. /posts/archive/$year $\to$ 2 ta statik, 1 ta dinamik (Keyingi ustuvorlik)
  3. /posts/$category/$id $\to$ 1 ta statik, 2 ta dinamik (Past ustuvorlik)
  4. /posts/$ $\to$ Wildcard / Splat (Faqat yuqoridagilar topilmasa ishlaydi)

3. Fayllarni yaratish tartibi ahamiyatga egami?

Eski routerlarda (masalan, React Router v4/v5 yoki oddiy if/else zanjirlarida) kodda birinchi yozilgan marshrut yutib chiqardi ("First match wins" qoidasi). Agar $postId.tsx fayli new.tsxdan oldin e'lon qilinsa, new.tsxga hech kim kira olmasdi.

TanStack Router’da esa:

  • Fayllarni papka ichida qanday tartibda yaratishingiz;
  • Ularni qaysi ketma-ketlikda nomlashingiz mutlaqo ahamiyatga ega emas!

TanStack Router Vite plagini loyihani tahlil qilayotganda barcha yo‘llarning og‘irligini hisoblab chiqadi va routeTree.gen.ts ichida har doim eng yuqori prioritetli yo‘llarni yuqoriga qo‘yadi.


4. Route Ranking qaror qabul qilish sxemasi

sequenceDiagram
    autonumber
    actor User as Foydalanuvchi
    participant Router as TanStack Router Engine
    participant Static as new.tsx (Statik)
    participant Dynamic as $postId.tsx (Dinamik)

    User->>Router: URL: /posts/new
    Router->>Router: Specificity Ranking baholandi
    Note over Router: Statik shablon topildi (/posts/new)!
    Router->>Static: 1. new.tsx yuklanadi va ekranga chiziladi
    Note over Router,Dynamic: $postId.tsx hatto so'rov yuborishga ulgurmaydi

5. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router
Ranking hisoblash vaqti Brauzer ishga tushganda (Runtime) Kompilyatsiya vaqtida (Compile-time AST orqali)
Kolliziyalar xavfi Murakkab shablonlarda ba'zan noaniqliklar bo‘ladi Matematik aniqlikda kafolatlangan (Zero Ambiguity)
Fayllar tartibiga bog‘liqlik Bog‘liq emas (v6 da), lekin konfiguratsiyada chalkashish mumkin Fayl tuzilishining o‘zi avtomatik to‘g‘ri saralanadi
Type-Safe integratsiya Havolalar bilan avtomatik bog‘lanmagan <Link to="/posts/new"> va $postId to‘liq ajratilgan

Xulosa

  • Route Ranking — bir xil manzilga da'vogar bo‘lgan bir nechta marshrutlar orasidan eng mosini aniqlash mexanizmidir.
  • Statik marshrutlar (/posts/new) har doim dinamik parametrlardan ($postId), dinamik parametrlar esa catch-all ($) shablonlaridan ustun turadi.
  • TanStack Router ushbu saralashni kompilyatsiya vaqtida avtomatik amalga oshiradi, shuning uchun fayllar qaysi ketma-ketlikda yaratilgani ahamiyatsiz.