Əsas məzmuna keç
FrontDepth, Ana səhifə

Arxitektura və pattern-lər

Klient tərəfində routing

Single-page tətbiqlər sənəd yükləmədən necə naviqasiya edir: History API və linklərin tutulmasından, deep link-lər üçün server fallback-dən, route-ların uyğunlaşdırılması və iç-içə qurulmasından data yükləməyə, code splitting-ə, guard-lara, naviqasiyadan sonrakı scroll və fokusa qədər.

JuniorMiddleSeniorYenilənib: 16 noyabr 2026

Oxu səviyyəsi

Seçilmiş səviyyəyə qədər olan bölmələr göstərilir.

Başlamazdan əvvəl

İlkin şərt yoxdur.

Bu mövzu Junior səviyyəsindən başlayır.

JuniorKonsepsiya

MPA və SPA-da naviqasiya

Multi-page tətbiqdə (MPA) hər link klikləməsi sənəd naviqasiyasıdır. Brauzer yeni URL-i sorğulayır, server tam HTML sənədi qaytarır, köhnə səhifə boşaldılır, yenisi isə sıfırdan parse olunur, stillənir və render edilir. Bu yolda brauzer çox işi pulsuz görür: ünvan sətrini və sessiya tarixçəsini yeniləyir, Back və Forward düymələrini işlədir, scroll mövqeyini bərpa edir, yükləmə göstəricisini göstərir, fokusu yeni sənədin əvvəlinə qaytarır, screen reader-lər də yeni səhifənin başlığını elan edir.

Single-page tətbiq (SPA) bir HTML sənədi yükləyir, sonra isə naviqasiyanı JavaScript-də idarə edir. O, kliki tutur, sənəd yükləmədən History API ilə URL-i dəyişir və yeni ekranı komponentlərdən və adətən JSON kimi gələn datadan render edir. Klient tərəfində routing budur.

Text
MPA: click → GET /products/42 → HTML → unload old page → parse, CSS, JS → render
SPA: click → preventDefault() → history.pushState(…, "/products/42") → load data → render route

Bu niyə lazımdır

  • State naviqasiyadan sonra da yaşayır. Audio pleyer çalmağa davam edir, yarımçıq yazılmış şərh öz sahəsində qalır, sidebar scroll mövqeyini saxlayır.
  • Yalnız dəyişən hissə yenidən render olunur. Header, naviqasiya və layout yerində qalır, yalnız məzmun hissəsi əvəzlənir.
  • Naviqasiya ani ola bilər. Route-un kodu və datası artıq yüklənibsə və ya prefetch olunubsa, şəbəkəyə ümumiyyətlə müraciət edilmir.

Bunun qiyməti

Router brauzerin əvvəllər gördüyü bütün işləri öz üzərinə götürür və unutduğu hər birini istifadəçi hiss edir: Back heç nə etmir, paylaşılan link 404 göstərir, səhifə yarıya qədər scroll olunmuş halda açılır, klikdən sonra screen reader susur. İlk ziyarət də yavaşlayır: server render olmadan heç nə görünməzdən əvvəl JavaScript bundle-ı yüklənib icra olunmalıdır, bu da -ni və -ni gecikdirir.

Bu gün vəziyyət necədir

İki model arasındakı sərhəd bulanıqlaşıb. Next.js, framework rejimində React Router, Nuxt və SvelteKit ilk səhifəni serverdə render edir, event handler-ləri ilə qoşur, ondan sonra isə klient tərəfində naviqasiyaya keçir. Brauzerlər adi sənəd naviqasiyasını da yaxşılaşdırmağa davam edir: back/forward cache bütöv səhifələri dərhal bərpa edir, növbəti səhifənin prefetch və ya prerender olunması (Speculation Rules API; MDN onu limited availability kimi göstərir, əsasən Chromium əsaslı brauzerlər dəstəkləyir) şəbəkə vaxtını gizlədir.

Ona görə əsl sual "SPA, yoxsa MPA" deyil: məhsulunda hansı naviqasiyalar klient tərəfində routing-dən fayda görür və onlar üçün brauzerin gördüyü işi yenidən qurmağa hazırsanmı? Bu mövzunun qalan hissəsi həmin siyahıdır.

JuniorVeb platforma

History API: pushState, replaceState, popstate

Klient tərəfində routing History API-nin üç hissəsinə söykənir:

JavaScript
history.pushState({ page: 2 }, "", "/products?page=2");
history.replaceState({ page: 3 }, "", "/products?page=3");

window.addEventListener("popstate", (event) => {
  render(location.pathname, event.state);
});
  • pushState(state, unused, url) sessiya tarixçəsinə yeni yazı əlavə edir və ünvan sətrini dəyişir. Brauzer URL-i yükləmir və heç bir hadisə işə salmır. URL cari URL ilə eyni origin-də olmalıdır, əks halda SecurityError atılır. state yazı ilə birlikdə structured clone kimi saxlanır (funksiya və DOM node olmaz, onlar DataCloneError atır) və history.state və event.state kimi geri qayıdır. İkinci arqument tarixi səbəblərdən qalıb; "" ötür.
  • replaceState() yeni yazı əlavə etmək əvəzinə cari yazını dəyişir. Onu redirect-lər, URL-in normallaşdırılması (/Products/ → /products) və daim dəyişən state üçün işlət, məsələn axtarış sahəsinin mətni üçün: hər düymə basışına bir yazı Back düyməsini yararsız edərdi.
  • popstate aktiv yazı traversal ilə dəyişəndə işə düşür: Back və Forward düymələri, history.back(), history.forward(), history.go(-2). pushState() və ya replaceState() çağırışı onu heç vaxt işə salmır.

Bundan çıxan iki nəticə hər router-in quruluşunu müəyyən edir:

  1. pushState()-dən sonra router özü render etməlidir. URL-in dəyişdiyini ona heç kim xəbər verməyəcək.
  2. history.back() asinxrondur. Növbəti sətirdə location və history.state hələ köhnə yazını göstərir; dəyişiklik sonra, popstate ilə gəlir. back()-i çağırıb dərhal URL-i oxuyan kod keçmişi oxuyur.

Hash routing

History API-dən əvvəl SPA-lar route-u fragment-də saxlayırdı: /#/products/42. location.hash-i dəyişmək sənəd yükləmir; tarixçəyə yazı əlavə edir və hashchange (ondan əvvəl isə popstate) hadisəsini işə salır. Fragment heç vaxt serverə göndərilmir, ona görə bütün route-lara eyni / cavab verir və deep link-lər istənilən statik hostda işləyir.

Bunun qiyməti: qəribə görünən URL-lər, fragment-dən eyni zamanda səhifədaxili anchor-lar üçün istifadə etmək olmur, server route-u heç vaxt render edə bilmir, çünki onu görmür, iki mexanizm isə bir-birinə qarışmır: pushState() yalnız hash dəyişəndə belə hashchange-i işə salmır. Hash routing başqasının səhifəsinə yerləşdirilən widget-lər, file://-dan açılan tətbiqlər və ya rewrite qaydalarını tənzimləyə bilmədiyin hostlar üçün hələ də normal seçimdir.

State harada yaşayır

history.state bir yazıya aid olan və URL-də olmamalı şeylər üçün yaxşıdır, məsələn siyahının scroll mövqeyi və ya hansı accordion-un açıq olduğu. Bəzi brauzerlər state-i diskə yazır və ölçüsünü məhdudlaşdırır, ona görə onu kiçik saxla; istifadəçinin paylaşa və ya bookmark edə bilməli olduğu hər şey URL-in özündə olmalıdır.

MiddleNümunə

Router: linkləri tutmaq, render, Back və Forward

Ən sadə history router-in dörd hissəsi var: link kliklərini tutmaq, URL-i push etmək, uyğun route-u render etmək və popstate-də yenidən render etmək.

JavaScript
function shouldIntercept(event, link) {
  return (
    !event.defaultPrevented &&
    event.button === 0 &&
    !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey &&
    (!link.target || link.target === "_self") &&
    !link.hasAttribute("download") &&
    link.origin === location.origin
  );
}

document.addEventListener("click", (event) => {
  const link = event.target.closest("a[href]");
  if (!link || !shouldIntercept(event, link)) return;
  event.preventDefault();
  navigate(link.pathname + link.search + link.hash);
});

function navigate(to, { replace = false } = {}) {
  if (replace) history.replaceState(null, "", to);
  else history.pushState(null, "", to);
  render();
}

window.addEventListener("popstate", render);

function render() {
  const match = matchRoute(routes, location.pathname);
  app.replaceChildren(match ? match.route.view(match.params) : notFoundView());
}

render();

Hər yoxlama niyə lazımdır

  • Modifikator düymələr və digər siçan düymələri. Ctrl/⌘+klik yeni tab, Shift+klik yeni pəncərə açır. Router bu kliklərin qarşısını alsa, təcrübəli istifadəçilər brauzerin əsas imkanlarını itirir.
  • target="_blank" və download. İstifadəçi tətbiqdaxili keçid yox, yeni tab və ya fayl istəyib.
  • Başqa origin-lər. Başqa sayta (və ya origin-i sənin olmayan mailto:-ya) aparan link tətbiqdən çıxmalıdır. Başqa origin üçün pushState() onsuz da xəta atardı.
  • defaultPrevented. Bu klik artıq başqa handler tərəfindən emal olunub.

Nəzərə almağa dəyən daha bir hal: cari səhifədə yalnız #hash-i dəyişən link. Onu brauzerin öhdəsinə buraxsan, anchor-a native scroll saxlanılır.

Naviqasiya üçün əsl <a href> elementlərindən istifadə et. Onlar JavaScript yüklənməzdən əvvəl də işləyir, üzərinə gələndə URL-i göstərir, "Open in new tab" və "Copy link"-i dəstəkləyir, crawler-lər onları izləyir, screen reader isə onları link kimi elan edir. <div onClick={() => navigate("/settings")}>-də bunların heç biri yoxdur. React Router-in <Link> komponenti <a> render edir və eyni filtri tətbiq edir: yalnız əsas düymə ilə, modifikatorsuz və _self-dən başqa target olmadan edilən klik.

Bu platformadakı Mini Router build layihəsi məhz bu dövrəni qurur, sonra ona uyğunlaşdırma və sıralama, iç-içə route-lar, guard-lar və loader-lər əlavə edir. Layihə eyni API-yə malik memory history işlədir (React Router-in createMemoryRouter-i kimi), çünki laboratoriyanın sandbox iframe-ində pushState() SecurityError atır.

Navigation API

Navigation API klik listener-ini və popstate-i router üçün vacib olan naviqasiyalarda işə düşən vahid navigate hadisəsi ilə əvəz edir: link klikləri, form göndərişləri, location-a mənimsətmələr, həmçinin tətbiqin öz yazıları arasında Back və Forward.

JavaScript
navigation.addEventListener("navigate", (event) => {
  if (!event.canIntercept || event.hashChange || event.downloadRequest !== null) return;
  const url = new URL(event.destination.url);
  event.intercept({
    async handler() {
      await renderRoute(url);
    },
  });
});

O, Baseline 2026-dır (yanvar 2026-dan yeni əlçatandır), yəni köhnə brauzerlər üçün History API fallback-i ilə bu gün istifadə oluna bilər. intercept() həm də handler bitdikdən sonra fokus və scroll üçün default davranış gətirir (focusReset, scroll).

MiddleVeb platforma

Deep link-lər və server fallback

History routing-də /products/42 yalnız klient router-inin içində mövcuddur. Tətbiqin içindən ora klikləmək işləyir. Səhifəni yeniləmək, bookmark-ı açmaq və ya paylaşılan linkə keçmək isə router-dən keçmir: brauzer /products/42-ni serverdən istəyir, yalnız index.html-i olan statik host da 404 qaytarır.

Həll fallback-dir (rewrite): real fayl olmayan hər URL-ə tətbiqin HTML-i ilə cavab verilir, JavaScript, CSS və şəkil kimi fayllar isə olduğu kimi göndərilir.

Text
# nginx
location / {
  try_files $uri $uri/ /index.html;
}

# Netlify, in _redirects
/*  /index.html  200

Development server adətən bunu sənin yerinə edir, "lokalda işləyir" deyib ilk deploy-dan sonra sınmasının səbəbi də budur.

Ağrı verən detallar

  • Nisbi asset URL-ləri. /products/42-dən yüklənən <script type="module" src="assets/app.js"> /products/assets/app.js kimi həll olunur. Belə fayl yoxdur, fallback index.html ilə cavab verir, brauzer isə HTML-i module skript kimi icra etməkdən imtina edir: boş səhifə, həm də yalnız deep link-lərdə. Kökdən başlayan URL-lərdən (/assets/app.js) istifadə et və ya bundler-in base path-ini tənzimlə.
  • Status kodu. Fallback hər URL-ə, o cümlədən /no-such-page-ə 200 ilə cavab verir. İstifadəçilər klient tərəfindəki "Not found" görünüşünü görür, crawler-lər isə uğurlu səhifə görür, yəni "soft 404". Server render varsa, əsl 404 qaytar. Tam statik hostda Google-un SPA-lar üçün tövsiyəsi həqiqətən 404 qaytaran URL-ə redirect etmək və ya not-found görünüşünə <meta name="robots" content="noindex"> əlavə etməkdir.
  • Eyni hostdakı API-lər. /api/* də index.html-ə düşürsə, endpoint adındakı hərf səhvi status 200 ilə HTML qaytarır və klient <!doctype html>-in JSON.parse-ında yıxılır. API yollarını fallback-dən çıxar.
  • Base path. Tətbiq /admin/ altında yaşayırsa, onu həm server qaydası, həm də router bilməlidir (React Router-in basename-i və bundler-in base path-i, məsələn Vite-in base-i).
  • Cache. index.html uzun müddət cache-lənməməlidir, yoxsa istifadəçilərdə silinmiş, hash-li bundle-lara istinad edən köhnə HTML qalır. Hash-li asset-ləri uzun müddət cache-lə, HTML-i isə revalidate et.

Çıxış yolu kimi hash routing

/#/products/42 olanda server yalnız /-i görür, ona görə bunların heç biri aktual deyil. Hash routing-in yerləşdirilən widget-lərdə və rewrite qaydası olmayan hostlarda yaşamağa davam etməsinin səbəbi budur. Əvəzində təmiz URL-lərdən, crawler-lərin görə bildiyi route-lardan (Google fərqli məzmunu fragment ilə yükləməməyi tövsiyə edir) və route-u serverdə render etmək imkanından imtina edirsən.

Server render ilə

Serverdə render edən framework-lərdə (Next.js, React Router-in framework rejimi, Nuxt, SvelteKit) fallback problemi yoxdur: hər route-un HTML render edən, düzgün status kodu qaytaran və redirect edə bilən əsl server handler-i var. Klient tərəfində routing yalnız ilk səhifə hydrate olunandan sonra işə qoşulur.

MiddleKonsepsiya

Route-ların uyğunlaşdırılması, sıralanması, parametrlər və iç-içə route-lar

Route şablonu statik seqmentlərdən (users), dinamik seqmentlərdən (:id) və bəzən splat, yəni catch-all seqmentdən (*) ibarət yoldur. Uyğunlaşdırma pathname-i / üzrə bölür və seqment-seqment müqayisə edir; dinamik seqmentlər parametrləri tutur.

Sıralama

Çox vaxt eyni URL-ə bir neçə şablon uyğun gəlir: /users/new həm /users/new, həm də /users/:id şablonuna uyğundur. Elan sırasında birincini seçmək kövrəkdir, çünki bir sətrin yerini dəyişmək davranışı dəyişir. Müasir router-lər bunun əvəzinə şablonları dəqiqliyinə görə sıralayır: statik dinamikdən, dinamik splat-dan üstündür. React Router hər route üçün bal hesablayır: hər statik seqment 10, hər dinamik seqment 3 əlavə edir, splat route isə cərimə alır.

Text
/users/new      static + static       wins for /users/new
/users/:id      static + dynamic      /users/42
/users/:id/*    + splat               /users/42/posts/7
/*              splat only            everything else (the 404 view)

Beləliklə, route-lar hansı sırada elan olunmasından asılı olmayaraq /users/new heç vaxt id-si "new" olan istifadəçi kimi tutulmur.

Bug-a səbəb olan detallar:

  • Parametrlər sətirdir. /users/42 "42" verir, /users/abc də uyğun gəlir. Çevir və yoxla, səhv id-lər üçün "not found" göstər.
  • Parametrlər percent-decode olunur. /tags/c%23 "c#" verir; URL-ləri encodeURIComponent() ilə qur.
  • Query və hash uyğunlaşdırmaya daxil deyil. /products?page=2 /products-a uyğun gəlir; query-ni ayrıca oxu.
  • Sondakı slash və hərf registri. /About/-un /about-a bərabər olub-olmadığına bir dəfə qərar ver və bir kanonik formaya redirect et.

İç-içə route-lar və layout-lar

URL-lər iyerarxikdir, interfeyslər də: /settings/profile tətbiqin qabığını, onun içində sidebar-lı settings layout-unu, onun da içində profil formasını göstərir. İç-içə route-lar bu ağacı təsvir edir, uyğunluq isə kökdən yarpağa qədər route-ların siyahısıdır. Hər biri öz hissəsini və uşağın yerləşəcəyi outlet-i render edir:

JSX
const router = createBrowserRouter([
  {
    path: "/",
    element: <AppShell />,
    children: [
      { index: true, element: <Home /> },
      {
        path: "settings",
        element: <SettingsLayout />,
        children: [
          { path: "profile", element: <Profile /> },
          { path: "billing", element: <Billing /> },
        ],
      },
      { path: "*", element: <NotFound /> },
    ],
  },
]);

/settings/profile-dan /settings/billing-ə keçəndə AppShell və SettingsLayout state-ləri və scroll mövqeləri ilə birlikdə yerində qalır, yalnız yarpaq əvəzlənir. Router-in hər səviyyə üçün datanı eyni anda yükləməsinə və bir səviyyədəki xətanı ətrafdakı layout-ları saxlayaraq göstərməsinə imkan verən də bu uyğunluq siyahısıdır. Next.js eyni ağacı qovluqlar və layout.js faylları ilə ifadə edir.

URLPattern

Platformanın artıq öz matcher-i var: new URLPattern({ pathname: "/users/:id" }).exec(url)?.pathname.groups.id. O, Baseline 2025-dir (sentyabr 2025-dən yeni əlçatandır) və Node-da da mövcuddur. Bir dəfəyə bir şablonu yoxlayır və sıralama aparmır, yəni sıra yenə sənin üzərinə düşür.

MiddleNümunə

State kimi URL, guard-lar və redirect-lər

State-in bir hissəsi səhifə yenilənəndən sonra da qalmalı, paylaşıla bilməli və ya Back ilə geri qaytarılmalıdırsa, onun yeri URL-dir: filtrlər, sıralama, axtarış sorğusu, səhifə nömrəsi, seçilmiş tab, açıq element. Yalnız komponent state-i bu üçünün hamısını itirir.

JavaScript
function readFilters(search) {
  const params = new URLSearchParams(search);
  return {
    q: params.get("q") ?? "",
    tags: params.getAll("tag"),
    page: Math.max(1, Number.parseInt(params.get("page") ?? "1", 10) || 1),
  };
}

function filtersToSearch({ q, tags, page }) {
  const params = new URLSearchParams();
  if (q) params.set("q", q);
  for (const tag of tags) params.append("tag", tag);
  if (page > 1) params.set("page", String(page));
  const search = params.toString();
  return search ? `?${search}` : "";
}

Bunu qaydasında saxlayan prinsiplər:

  • Həqiqət mənbəyi URL-dir. Filtrləri hər render-də ondan oxu və UI-ı ondan çıxar; state-də uyğunsuzlaşa biləcək ikinci surət saxlama.
  • Push və ya replace-i şüurlu seç. Back ilə geri qaytarılmalı olan ayrı-ayrı seçimlər (filtr tətbiq etmək, 3-cü səhifəyə keçmək) push işlədir. Davamlı daxiletmə (axtarış sahəsində hər düymə basışı) replace işlədir, yoxsa Back hər hərfi bir-bir gəzəcək.
  • Default dəyərləri URL-ə yazma. ?page=1&sort=relevance hər paylaşılan linkə səs-küy qatır; default-a bərabər dəyərləri burax.
  • Yoxla. İnsanlar URL-ləri əl ilə dəyişir: ?page=-1, ?page=abc, naməlum tag-lar. readFilters kimi ehtiyatla parse et.
  • Kodlaşdırmanı bil. URLSearchParams boşluğu + kimi seriallaşdırır və siyahılar üçün açarı təkrarlayır (?tag=a&tag=b); siyahıları getAll() ilə oxu.

React Router (useSearchParams) və Next.js (useSearchParams, router.replace) eyni modeli verir.

Guard-lar və redirect-lər

Guard render-dən əvvəl naviqasiyanın davam edə bilib-bilməyəcəyinə qərar verir: hesabdan çıxmış istifadəçi /settings-i açanda /login?next=/settings-ə gedir; yadda saxlanmamış dəyişiklikləri olan form təsdiq istəyir.

  1. Redirect-i replace ilə et. /settings /login-i push edirsə, login səhifəsindən Back yenidən /settings-ə qaytarır, o da yenidən redirect edir: istifadəçi ilişib qalır. Bunun əvəzinə yazını əvəzlə, daxil olduqdan sonra isə /login-i next yolu ilə replace et.
  2. next-i yoxla. Yalnız eyni origin-ə aid yolları (tək / ilə başlayan) qəbul et, yoxsa ?next=https://evil.example login səhifəni open redirect-ə çevirir.
  3. Klient guard-ları təhlükəsizlik yox, UX-dir. Hər kəs klient kodunu dəyişə və ya API-ni birbaşa çağıra bilər, ona görə hər sorğunu server avtorizasiya etməlidir. React Router sənədləri loader-lər haqqında eyni şeyi deyir: uyğun gələn loader-lər paralel işləyir, ona görə valideyn loader uşaqlarını qoruya bilmir, hər loader girişi özü yoxlamalıdır (və ya middleware).
  4. Yadda saxlanmamış dəyişikliklər. beforeunload səhifənin yenilənməsini və tab-ın bağlanmasını əhatə edir; tətbiqdaxili naviqasiyalar üçün router-in blocker-i (React Router-də useBlocker) və ya eyni sənəd daxilindəki naviqasiyaları ləğv edə bilən Navigation API navigate hadisəsi lazımdır.
SeniorFramework

Hər route üçün data yükləmə və code splitting

Sadəlövh SPA datanı komponentlərin içində, effektlərdə sorğulayır. /projects/7/tasks ProjectLayout-u render edir, onun effekti layihəni sorğulayır; cavab gələndə TaskList render olunur və onun effekti tapşırıqları sorğulayır; sonra hər tapşırıq sətri öz icraçısını sorğulayır. Hər sorğu yalnız əvvəlki komponent render olunandan sonra başlayır: bu, waterfall-dır. Lazy yüklənən route-da vəziyyət daha da pisləşir, çünki birinci sorğunun başlaya bilməsi üçün əvvəlcə kod gəlməlidir.

Text
effects:  [route JS] → [project] → [tasks] → [assignees] → done
loaders:  [route JS]
          [project]
          [tasks]   → render once, done

Route loader-ləri

Router heç nə render olunmazdan əvvəl yalnız URL-ə baxıb hansı route-ların uyğun gəldiyini bilir. Ona görə o, bütün uyğun route-ların data sorğularını naviqasiya anında, hətta link-in üzərinə gəlinəndə daha tez, paralel başlada bilər:

JavaScript
const router = createBrowserRouter([
  {
    path: "/projects/:projectId",
    element: <ProjectLayout />,
    loader: async ({ params, request }) => {
      const res = await fetch(`/api/projects/${params.projectId}`, { signal: request.signal });
      if (!res.ok) throw new Response("Not found", { status: res.status });
      return res.json();
    },
    errorElement: <ProjectError />,
    children: [
      {
        path: "tasks",
        lazy: () => import("./routes/tasks.jsx"),
      },
    ],
  },
]);

Yaxşı qurulmuş loader-lər sənə nə verir:

  • Paralel sorğular. Valideynin və uşağın datası eyni vaxtda yüklənir; ekran lazım olan hər şeylə bir dəfə render olunur.
  • Ləğvetmə. İstifadəçi yenidən naviqasiya edəndə əvvəlki naviqasiyanın request.signal-ı abort olunur. Bu olmasa, /projects/1 üçün gec gələn cavab /projects/2-nin tez gələn cavabından sonra çatıb daha yeni ekranın üstünə yaza bilər. Router hansı olursa olsun, qayda belədir: "sonuncu naviqasiya qalib gəlir".
  • Gözləmə UI-ı. Bir anlıq boş səhifə göstərmək əvəzinə köhnə ekranı progress göstəricisi ilə saxla (useNavigation().state === "loading") və ya yavaş data üçün skeleton göstər.
  • Seqment üzrə xətalar. Uğursuz loader ən yaxın errorElement-i render edir; ondan yuxarıdakı layout-lar ekranda qalır.

Loader-lər data cache-ini əvəz etmir. TanStack Query, SWR və ya framework-ün cache-i yenə də təkrar sorğuları birləşdirir və datanı revalidate edir; loader-lər isə yükləmənin nə vaxt başlayacağına qərar verir.

Hər route üçün code splitting

Route-lar təbii bölünmə nöqtələridir: /settings-də olan istifadəçiyə /reports-un qrafik kitabxanası lazım deyil. <Suspense> ilə React.lazy() komponenti bölür, amma import yalnız komponent render olunanda, valideynindən sonra başlayır. Router səviyyəsindəki lazy (yuxarıdakı kimi) route modulunu naviqasiya zamanı, valideynin datası ilə paralel yükləyir. Gecikmənin qalanını prefetch gizlədir: Next.js-in <Link>-i production-da link görünüşə daxil olanda route-u prefetch edir, bir çox router isə üzərinə gəlmə və ya fokus zamanı prefetch edir.

Müsahibədə adını çəkməli olduğun kompromis: hər prefetch trafik və server işi deməkdir, ona görə bütün tətbiqi yox, ehtimal olunan növbəti addımları (görünən linklər, üzərinə gəlmə niyyəti) prefetch et.

SeniorTipik səhvlər

Naviqasiyadan sonra: scroll, fokus və səhifənin elan olunması

Brauzerin hər sənəd naviqasiyasında gördüyü üç iş artıq router-in üzərinə düşür.

Scroll

İstifadəçi gözləyir ki, yeni səhifə yuxarıdan (və ya öz #fragment-indən) başlasın, Back isə onu olduğu yerə qaytarsın. Brauzerin öz bərpası (history.scrollRestoration = "auto", Baseline, yanvar 2020-dən geniş əlçatandır) yazı traversal ilə dəyişəndə işləyir, SPA-da isə bu çox vaxt tezdir: əvvəlki səhifənin datası hələ yüklənir, sənəd çox qısadır və mövqe itir. Ona görə router-lər "manual"-a keçir, scroll mövqeyini hər tarixçə yazısı üçün saxlayır (çox vaxt sessionStorage-da, yazının açarı ilə) və route öz məzmununu render etdikdən sonra bərpa edir. React Router-in <ScrollRestoration /> komponenti məhz bunu edir və scrollRestoration-u "manual" edir. Next.js-in <Link>-i yeni səhifə artıq görünürsə scroll mövqeyini saxlayır, əks halda yeni səhifə seqmentinin əvvəlinə scroll edir. Səhifənin içindəki scroll olunan panellər də eyni yanaşma tələb edir, yoxsa uzun sidebar siyahısı yenidən yuxarı atılır.

Fokus

Linkə klikləyəndən sonra fokus həmin linkdə olur. Sonra router məzmunu əvəz edir:

  • link əvəzlənən məzmunun içində idisə, silinir və fokus <body>-yə düşür;
  • daimi naviqasiyada idisə, fokus orada qalır və klaviatura istifadəçisi yeni məzmuna çatmaq üçün bütün menyunu yenidən Tab ilə keçməli olur;
  • hər iki halda screen reader-ə yeni səhifə haqqında heç nə deyilmir.

Adi həll fokusu yeni səhifənin əsas başlığına köçürməkdir: bu, screen reader-in onu oxumasını təmin edir və növbəti Tab-ı məzmuna yönəldir:

JavaScript
function afterNavigation(title) {
  document.title = `${title} · Shop`;
  const heading = document.querySelector("main h1");
  if (heading) {
    heading.setAttribute("tabindex", "-1");
    heading.focus({ preventScroll: true });
  }
}

preventScroll: true scroll-u yuxarıdakı scroll məntiqinin öhdəsinə buraxır. Alternativlər səhifənin yuxarısındakı wrapper-i və ya skip link-i fokuslamaqdır, bu da yeni səhifə yüklənməsini təqlid edir. Səhifə dəyişikliyi olmayan hallarda fokusu köçürmə: ?q=-nu yeniləyən axtarış sahəsinə yazmaq, hash-i yeniləyən tab-lar arasında keçid, modal route-un açılması. İnsan yazarkən fokusun başqa yerə atılması fokus idarəetməsinin olmamasından daha pisdir.

Navigation API-də bunun üçün default davranış var: tutulmuş naviqasiyanın handler-i bitəndə focusReset: "after-transition" autofocus olan birinci elementi və ya <body>-ni fokuslayır. Öz məntiqini işlətmək üçün focusReset: "manual" ötür.

Səhifənin elan olunması

Hər route-da document.title-ı yenilə: brauzer onu tab-larda və tarixçədə göstərir, screen reader-lər isə əsl səhifə yüklənməsində məhz onu elan edir. Klient tərəfində naviqasiya üçün polite live region-da elan ("Order history") əlavə et və ya framework-ə güvən: Next.js-in hazır route announcer-i əvvəlcə document.title-ı, sonra birinci <h1>-i, sonra pathname-i oxuyur. Cari naviqasiya linkini aria-current="page" ilə işarələ.

Yavaş naviqasiyalarda istifadəçiyə nəyinsə baş verdiyini də bildir: görünən progress göstəricisi, uzun gözləmələrdə isə polite status mesajı. Live region-ları ARIA, accessible name və fokus idarəetməsi mövzusu ətraflı izah edir.

SeniorMüsahibə məsləhətləri

Müsahibə üçün məsləhətlər

30 saniyəlik cavab. "Klient router-i eyni origin-ə aid link kliklərini tutur, sənəd yükləmədən URL-i history.pushState() ilə yeniləyir, yolu sıralanmış route cədvəli ilə müqayisə edir və uyğun gələn route-ları layout-dan səhifəyə qədər iç-içə render edir. popstate-də Back və Forward üçün yenidən render edir. Brauzer artıq naviqasiya etmədiyi üçün onun işlərini router öz üzərinə götürür: deep link-lər üçün serverdə fallback lazımdır, data yükləməni, scroll-u, fokusu və səhifə başlığını isə router idarə edir."

Gözlənilən suallar

  • Kiçik bir router yaz. pushState, popstate listener-i, parametrləri olan matcher. pushState()-in popstate-i işə salmadığını açıq de və tutulmamalı olan klikləri sadala.
  • Hash, yoxsa history routing? Server konfiqurasiyası, server render, crawler-lər üçün görünmə, təmiz URL-lər və hash routing-in hələ də mənalı olduğu yerlər.
  • /dashboard/settings-i yeniləyəndə production-da 404 alınır, lokalda isə yox. Niyə? Dev server-də fallback var, production hostda yoxdur; həmçinin nisbi asset yolları və hər şeyə 200 verən soft 404.
  • Router /users/new ilə /users/:id arasında necə seçim edir? Elan sırasına görə yox, dəqiqliyə görə sıralama ilə.
  • Naviqasiya zamanı səhifə yavaş hiss olunur. Nəyə baxarsan? Effektlərdəki sorğuların waterfall-ı, paralel işləyən loader-lər, route səviyyəsində code splitting, prefetch, boş ekran əvəzinə gözləmə UI-ı.
  • İki sürətli klik səhv səhifəni göstərir. Niyə? Race condition: əvvəlki naviqasiyanın sorğularını abort et və ya sonuncu naviqasiyaya aid olmayan nəticələri nəzərə alma.
  • Klient tərəfində naviqasiya əlçatandırmı? Fokus, başlıq, elanlar, scroll-un bərpası.
  • Filtr state-i harada yaşamalıdır? URL-də; ayrı-ayrı seçimlər üçün push, yazı üçün replace.

Bal itirdən səhvlər

  • Əsl <a href> əvəzinə div və ya button üzərində onClick ilə naviqasiya.
  • pushState()-dən sonra popstate gözləmək və ya history.back()-dən dərhal sonra location-u oxumaq.
  • Klient tərəfindəki guard-ı giriş nəzarəti kimi qəbul etmək.
  • Server fallback-i, 404 statusunu və ya nisbi asset URL-lərini unutmaq.
  • Hər düymə basışına bir tarixçə yazısı.

Senior səviyyəni göstərən məqamlar

Alətlərdən yox, kompromislərdən danış. Server render ilə MPA nə vaxt daha yaxşı məhsuldur? Navigation API-yə (Baseline 2026) keçid nə qazandırır və hələ hansı fallback lazımdır? Prefetch trafik və server yükü baxımından nəyə başa gəlir? URL-lərə public API kimi bax: sabit, paylaşıla bilən, dəyişəndə redirect-lərlə. Və yalnız ilk yüklənməni yox, naviqasiyaları da ölç: route keçidləri qarşılıqlı əlaqədir, ona görə INP-yə və klik → məzmun üçün öz zaman nişanlarına bax.

JuniorYoxlama siyahısı

Klient tərəfində routing kodunu review edərkən nəyi yoxlamalı

Bu siyahını özün yazmadığın routing kodunu review edəndə işlət: komanda yoldaşının, kitabxananın və ya AI assistentin kodunu. Hər bənd brauzerin sənəd naviqasiyasında özü gördüyü bir işdir; birini buraxsan, Back işləmir, paylaşılan link 404 göstərir və ya screen reader susur.

  • Naviqasiya əsl <a href> ilə edilirmi və router-in tutmamalı olduğu kliklər brauzerə buraxılırmı? onClick-li div "Open in new tab"-ı və crawler-ləri itirir. Ctrl/⌘+klik, Shift+klik, target="_blank", download və başqa origin-lərə aparan linklər brauzerə toxunulmadan çatmalıdır.
  • Kod pushState()-dən dərhal sonra, bir də popstate-də render edirmi? pushState() heç bir hadisə işə salmır. Linkə kliklə, sonra Back və Forward düymələrini bas: ekran URL-in ardınca dəyişməlidir.
  • Deep link production build-də işləyirmi? /products/42 səhifəsini dev server-də yox, deploy olunmuş build-də yenilə. Hostda real faylları və /api/* yollarını kənarda saxlayan, qalan URL-lərə index.html qaytaran fallback olmalıdır; Network panelində skriptlər kökdən başlayan URL-lərdən yüklənməli, HTML kimi qayıtmamalıdır.
  • Guard-lar redirect-i replace ilə edirmi və next-i yoxlayırmı? Push ilə edilən redirect Back düyməsini redirect dövrəsinə salır. Yalnız tək / ilə başlayan və ardınca \ gəlməyən next-i qəbul et: //evil.example və /\evil.example başqa saytdır. Klient guard-ları UX-dir: girişi API də yoxlamalıdır.
  • URL state-i şüurlu şəkildə push və ya replace olunurmu, yoxlanılırmı? Axtarış sahəsinə yazmaq replace etməlidir, yoxsa Back hər hərfi bir-bir gəzəcək. Parametrlər sətirdir: ?page=abc və /users/abc ünvanlarını sına, kodun yıxılmasını yox, defolt dəyəri və ya "not found" görünüşünü gözlə.
  • Naviqasiyadan sonra səhifə başlığı, fokus və scroll idarə olunurmu? document.title dəyişməli, fokus əsas başlığa keçməli (tabindex="-1"), yeni səhifələr yuxarıdan başlamalı, Back isə köhnə mövqeyi bərpa etməlidir. Növbəti Tab yeni məzmuna düşməlidir.

Özünü yoxla

  • Məşq

    Kodun nəticəsini təxmin et, açıq müsahibə suallarına cavab ver və özünü qiymətləndir.

    4 nəticə sualı · 3 açıq sual

  • Quiz

    İzahlı test sualları və yekun nəticə.

    5 sual

Bu mövzudan istifadə edən praktiki işlər.