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:
/posts/archive/2026$\to$ 3 ta statik segment (Eng yuqori ustuvorlik)/posts/archive/$year$\to$ 2 ta statik, 1 ta dinamik (Keyingi ustuvorlik)/posts/$category/$id$\to$ 1 ta statik, 2 ta dinamik (Past ustuvorlik)/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.