Series: React Router Lesson 32

Route ranking va matching — Bir nechta mos route orasidan keraklisini tanlash

React Router v6 da Route ranking va matching mexanizmi: aniqlik darajasi bo'yicha baholash tizimi, statik vs dinamik ustunligi va v5'dagi 'route shadowing' muammosining yechimi.

32-dars

Route ranking va matching — Bir nechta mos route orasidan keraklisini tanlash

Tasavvur qiling, siz pochta bo‘limida xat tarqatuvchisiz va stolingiz ustida ikkita konvert yotibdi:

  1. Birinchi konvert ustida aniq manzil yozilgan: "Toshkent shahri, Chilonzor 5-mavze, 'Yangi bino'".
  2. Ikkinchi konvert ustida esa umumiy shart yozilgan: "Toshkent shahri, Chilonzor 5-mavze, [Istalgan xonadon raqami]".

Agar sizga kuryer kelib: "Menga 'Yangi bino' uchun xatni bering" desa, siz qaysi konvertni berasiz? Albatta, birinchi bo‘lib aniq nom yozilgan konvertni berasiz! Shartli va umumiy xatlarga esa faqat aniq nom topilmagandagina qaraysiz.

Veb-ilovalarda ham aynan shunday vaziyat har kuni sodir bo‘ladi. Tasavvur qiling, sizda ikkita marshrut bor:

  • /candidates/new — Yangi nomzod qo‘shish sahifasi;
  • /candidates/:id — Aniq bir nomzodning profil sahifasi.

Foydalanuvchi brauzerda /candidates/new manzilini ochganda, router "new" so‘zini oddiy dinamik :id parametri deb adashtirib yubormasligi kerak. Aynan mana shunday to‘qnashuvlarni xatosiz hal qilish uchun React Router’da Route ranking (reytinglash) va Matching (solishtirish) algoritmi ishlaydi.


Eski v5 ("First match wins") vs Zamonaviy v6 ("Ranking")

React Router evolyutsiyasidagi eng katta inqiloblardan biri aynan shu yerda sodir bo‘lgan:

graph TD
    subgraph React Router v5 (Eski usul)
        A1["URL: /candidates/new"] --> A2["1-qator: /candidates/:id"]
        A2 -->|Mos keldi deb o'yladi!| A3["❌ XATO: 'new' so'zini :id deb o'qib yubordi!"]
        A4["2-qator: /candidates/new"] -.->|Hech qachon yetib bormaydi| A5["Shadowed bo'lib qoldi"]
    end

    subgraph React Router v6 (Zamonaviy algoritm)
        B1["URL: /candidates/new"] --> B2["Barcha mos yo'llar ball bilan baholanadi"]
        B2 --> B3["/candidates/:id -> 3 ball<br/>/candidates/new -> 10 ball (Aniq statik so'z)"]
        B3 --> B4["✅ G'OLIB: Tartibdan qat'i nazar /candidates/new ochiladi!"]
    end

React Router v5 dagi muammo:

Eski versiyada route'lar kodda qaysi tartibda yozilgan bo‘lsa, tepadan pastga qarab birma-bir tekshirilardi. Agar dasturchi ehtiyotsizlik qilib :id yo‘lini new yo‘lidan teparoqqa yozib qo‘ysa, new sahifasiga hech kim kira olmas edi (bunga dasturlashda Route Shadowing deyiladi).

React Router v6 dagi yechim:

React Router v6 da kodning yozilish tartibi umuman ahamiyatga ega emas!
Kutubxona barcha route'larni o‘zining ichki matematik reyting algoritmi (Scoring System) orqali baholab chiqadi va qaysi yo‘l eng aniq (specific) bo‘lsa, o‘shani birinchi o‘ringa qo‘yadi.


Reyting tizimi qoidalari (Qaysi biri ustun?)

React Router route'larning har bir segmentiga quyidagi mezonlar bo‘yicha ball beradi:

Segment turi Misol Ball darajasi Tavsif
1. Static segments /candidates/new, /edit Eng yuqori (Eng kuchli) Aniq o‘zgarmas so‘zlar. 100% aniqlik.
2. Dynamic segments /candidates/:id O‘rta O‘zgaruvchan parametrlar. Har qanday so‘zga mos keladi.
3. Splat / Wildcard /candidates/* Eng past (Eng zaif) Barcha qolgan narsalarni yutib oluvchi oxirgi chora.

[!IMPORTANT] Qoida: Har doim statik so‘z dinamik parametrdan ustun turadi, dinamik parametr esa yulduzcha (*) splat'dan ustun turadi!


Matematik misol: Ballar qanday hisoblanadi?

Foydalanuvchi https://sayt.uz/candidates/new manzilini ochdi. Bizda quyidagi 3 ta route bor:

  1. path="/candidates/*" $\rightarrow$ Statik segment (candidates) + Wildcard (*) = Past ball
  2. path="/candidates/:id" $\rightarrow$ Statik segment (candidates) + Dinamik parametr (:id) = O‘rta ball
  3. path="/candidates/new" $\rightarrow$ Statik segment (candidates) + Statik segment (new) = ENG YUQORI BALL (G‘olib!)

Natijada kodda qayerda turganidan qat'i nazar, aynan 3-raqamli CandidateNew komponenti ekranga chiziladi!


Amaliy kod: Tartib ahamiyatsiz ekanligini isbotlash

Quyidagi kodda :id yo‘li new yo‘lidan oldin yozilgan bo‘lsa ham, React Router v6 algoritmi uni qanday to‘g‘ri hal qilishini ko‘ramiz:

import { Routes, Route } from 'react-router-dom';
import CandidatesList from './pages/CandidatesList';
import CandidateNew from './pages/CandidateNew';       // Yangi nomzod qo'shish
import CandidateDetail from './pages/CandidateDetail'; // Nomzod tafsiloti
import NotFoundPage from './pages/NotFoundPage';

export default function AppRoutes() {
  return (
    <Routes>
      <Route path="/candidates" element={<CandidatesList />} />

      {/* ⚠️ Dinamik parametr tepada yozilgan bo'lsa ham: */}
      <Route path="/candidates/:id" element={<CandidateDetail />} />

      {/* ...Aniq statik yo'l pastda turganiga qaramasdan,
          /candidates/new ochilganda avval mana shu komponent ishlaydi! */}
      <Route path="/candidates/new" element={<CandidateNew />} />

      {/* Wildcard esa eng past reytingga ega bo'lib, oxirida ishlaydi */}
      <Route path="/candidates/*" element={<NotFoundPage />} />
    </Routes>
  );
}

Foydalanuvchi harakatlanganda:

  • /candidates/new $\rightarrow$ <CandidateNew /> ochiladi (id = "new" bo‘lib adashmaydi!).
  • /candidates/77 $\rightarrow$ <CandidateDetail /> ochiladi (id = "77").
  • /candidates/77/unknown/deep/path $\rightarrow$ Yuqoridagi ikkalasiga mos kelmagani uchun <NotFoundPage /> ochiladi.

Durang holatda nima bo‘ladi? (Tie-Breaker)

Agar ikkita route'ning reyting balli mutlaqo teng bo‘lib qolsa-chi?

Masalan:

<Route path="/items/:id" element={<ItemOne />} />
<Route path="/items/:slug" element={<ItemTwo />} />

Ikkala yo‘l ham bitta statik segment va bitta dinamik segmentdan iborat (ballari bir xil). Faqat va faqat mana shunday kamdan-kam uchraydigan durang holatdagina React Router kodda birinchi bo‘lib yozilgan yo‘lni tanlaydi.


Route Ranking tizimining 3 ta katta foydasi

  1. Route Shadowing xatosi yo‘q: Dasturchi route'larni qaysi tartibda joylashtirish haqida bosh qotirib o‘tirmaydi.
  2. Kodni erkin tashkil qilish: Xohlagan route'ingizni faylning xohlagan joyiga yozishingiz yoki modullarga bo‘lib qo‘yishingiz mumkin.
  3. Kutilgan va tabiiy ishlash: Aniq yozilgan sahifalar har doim umumiy qoliplardan ustun ekanligi kafolatlanadi.

Xulosa

  • React Router v6 da yo‘llarni tanlash kod tartibiga emas, aniqlik reytingiga (Ranking) asoslanadi.
  • Ustunlik tartibi: Statik so‘zlar (/new) > Dinamik parametrlar (/:id) > Splat (/*).
  • Bu tizim dasturchilarni kutilmagan marshrut xatolaridan to‘liq himoya qiladi.