Series: React Basics Lesson 85

Error Boundaries — Render xatolarini chegaralash va fallback UI

React ilovalarida 'oq ekran' halokatini oldini olish, Error Boundary klass komponenti, getDerivedStateFromError, componentDidCatch va xatolarni lokallashtirish strategiyasi.

85-dars

Error Boundaries — Render xatolarini chegaralash va fallback UI

React ilovalarida qanchalik sifatli kod yozilmasin, kutilmagan vaziyatlar — masalan, backend'dan null qiymat kelishi, undefined obyekt xossasiga murojaat qilish (user.profile.avatar) yoki formatlashdagi xatolar yuz berishi mumkin.

Odatiy holatda, agar bitta kichik komponent render paytida JavaScript xatosi bersa, React xavfsizlik nuqtai nazaridan butun komponentlar daraxtini DOM'dan o'chirib yuboradi. Natijada foydalanuvchi ko'z o'ngida "White Screen of Death" (Butunlay oppoq bo'sh ekran) paydo bo'ladi. Ushbu halokatli holatning oldini olish uchun Error Boundaries (Xatolar chegarasi) ishlatiladi.


Error Boundary o'zi nima?

Error Boundary — bu o'zining ichki bola komponentlarida (child components) yuz bergan render xatolarini ushlab qoluvchi, xatolik ma'lumotlarini qayd qiluvchi (logging) va butun ilova qulashining o'rniga chiroyli Fallback UI (zaxira interfeys) ko'rsatuvchi maxsus komponentdir.

[!NOTE] Hozirgi kunda React'da Error Boundary yaratish uchun Class Component (sinf komponenti) yozish shart. Funksional komponentlar uchun hali rasmiy Hook (useCatch kabi) mavjud emas.


Error Boundary nimalarni ushlaydi va nimalarni USHLAMAYDI?

Ko'p dasturchilar Error Boundary'ni hamma narsani ushlaydigan universal "sehrli qalqon" deb o'ylashadi. Aslida esa uning qat'iy chegaralari bor:

Xatolik turi Error Boundary ushlay oladimi? To'g'ri yechim
Render jarayoni (JSX ichida undefined.map()) ✅ HA Error Boundary avtomatik ushlaydi
Konstruktor va Lifecycle metodlari ✅ HA Error Boundary avtomatik ushlaydi
Hodisalar ichida (onClick, onSubmit) ❌ YO'Q Oddiy try/catch blokidan foydalanish
Asinxron kod (setTimeout, fetch, async/await) ❌ YO'Q try/catch yoki .catch() orqali ushlash
Server-Side Rendering (SSR) ❌ YO'Q Server darajasidagi xatolarni qayta ishlash
Error Boundary'ning o'zidagi xatolik ❌ YO'Q Undan yuqoriroqdagi boshqa Error Boundary

To'liq TypeScript Error Boundary kodi

Keling, qayta urinish (Retry/Reset) imkoniyatiga ega bo'lgan to'liq va qayta ishlatiluvchi Error Boundary komponentini yaratamiz:

import React, { Component, type ErrorInfo, type ReactNode } from 'react';

// 1. Props va State interfeyslari
interface ErrorBoundaryProps {
  children: ReactNode;
  fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
  onError?: (error: Error, errorInfo: ErrorInfo) => void;
}

interface ErrorBoundaryState {
  hasError: boolean;
  error: Error | null;
}

// 2. Class Component
export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
  public state: ErrorBoundaryState = {
    hasError: false,
    error: null,
  };

  // Render fazasida xatolik yuz berganda state'ni yangilaydi
  public static getDerivedStateFromError(error: Error): ErrorBoundaryState {
    return { hasError: true, error };
  }

  // Commit fazasida xatoni log qilish yoki Sentry'ga yuborish uchun chaqiriladi
  public componentDidCatch(error: Error, errorInfo: ErrorInfo) {
    console.error('🚨 ErrorBoundary xatoni ushladi:', error, errorInfo);
    
    // Agar tashqaridan monitoring funksiyasi uzatilgan bo'lsa
    if (this.props.onError) {
      this.props.onError(error, errorInfo);
    }
  }

  // State'ni tozalab qayta urinish funksiyasi
  public handleReset = () => {
    this.setState({ hasError: false, error: null });
  };

  public render() {
    if (this.state.hasError && this.state.error) {
      // Agar tashqaridan funksiya ko'rinishidagi fallback berilgan bo'lsa
      if (typeof this.props.fallback === 'function') {
        return this.props.fallback(this.state.error, this.handleReset);
      }

      // Agar tayyor ReactNode fallback berilgan bo'lsa
      if (this.props.fallback) {
        return this.props.fallback;
      }

      // Standart zaxira interfeys
      return (
        <div style={{
          padding: '20px',
          margin: '12px 0',
          backgroundColor: '#fef2f2',
          border: '1px solid #f87171',
          borderRadius: '8px',
          color: '#991b1b'
        }}>
          <h4 style={{ margin: '0 0 8px 0' }}>⚠️ Kutilmagan nosozlik yuz berdi!</h4>
          <p style={{ margin: '0 0 12px 0', fontSize: '14px', fontFamily: 'monospace' }}>
            {this.state.error.message}
          </p>
          <button
            onClick={this.handleReset}
            style={{
              padding: '6px 14px',
              backgroundColor: '#dc2626',
              color: 'white',
              border: 'none',
              borderRadius: '4px',
              cursor: 'pointer'
            }}
          >
            Qayta urinish
          </button>
        </div>
      );
    }

    return this.props.children;
  }
}

Amaliy misol: Ataylab xato chiqaruvchi komponent

import React, { useState } from 'react';

// Xatolik chiqaruvchi sinov komponenti
function BuggyProfile() {
  const [shouldCrash, setShouldCrash] = useState(false);

  if (shouldCrash) {
    // Render vaqtidagi xatolik simulyatsiyasi
    throw new Error("Foydalanuvchi profil ma'lumotlarini o'qib bo'lmadi!");
  }

  return (
    <div style={{ padding: '12px', border: '1px solid #e2e8f0', borderRadius: '6px' }}>
      <p>Foydalanuvchi: Alisher Zokirov</p>
      <button 
        onClick={() => setShouldCrash(true)}
        style={{ padding: '6px 10px', backgroundColor: '#ef4444', color: 'white', border: 'none', cursor: 'pointer' }}
      >
        Xatolikni yuzaga keltirish 💥
      </button>
    </div>
  );
}

// Ilova tarkibida ishlatish:
export default function App() {
  return (
    <div style={{ padding: '24px', maxWidth: '450px' }}>
      <h2>Profil Sahifasi</h2>

      {/* ErrorBoundary faqat o'z ichidagi xatolikni ushlaydi */}
      <ErrorBoundary>
        <BuggyProfile />
      </ErrorBoundary>

      <p style={{ marginTop: '16px', color: '#64748b', fontSize: '13px' }}>
        ℹ️ Agar yuqoridagi komponent qulasa ham, sahifaning ushbu qismi va menyular bemalol ishlayveradi.
      </p>
    </div>
  );
}

Xatolarni chegaralash strategiyasi (Granular Boundaries)

Eng yaxshi amaliyot — Error Boundary'ni faqat butun ilova tepasiga bitta qilib qo'yish bilan cheklanmasdan, uni alohida mustaqil vidjetlar atrofida ham ishlatishdir:

  1. Global Boundary (Ilova darajasida): Eng yuqorida (Root) turadi. Agar qolgan barcha himoyalar ish bermay qolsa, butun ilova o'rniga "Kechirasiz, tizimda nosozlik. Sahifani yangilang" oynasini ko'rsatadi.
  2. Kichik vidjetlar darajasida (Granular): Masalan: Ob-havo vidjeti, Sharhlar qutisi yoki Tavsiyalar karuseli. Agar "Ob-havo" qismida xato bo'lsa, faqat o'sha 100 piksel joyda "Ob-havoni yuklab bo'lmadi" deb turadi, lekin foydalanuvchi saytning qolgan barcha xizmatlaridan hech qanday to'siqsiz foydalanaveradi!

Real hayotiy analogiya: Elektr taqsimlash qutisi (Avtomat / Sig'orta)

Tasavvur qiling, uyingizdagi elektr tizimida har bir xona uchun alohida avtomat (sig'orta) o'rnatilgan:

  • Oshxonadagi qahva qaynatgichda qisqa tutashuv (crash) yuz berdi.
  • Faqat oshxonaning elektr avtomati (Error Boundary) "chert" etib o'chadi.
  • Mehmonxona, yotoqxona, televizor va muzlatkich esa o'z faoliyatini davom ettiraveradi.

Agar elektr shitida bu xavfsizlik avtomatlari bo'lmaganida, bitta choynak sabab butun uy elektrsiz ("oq ekran") qolgan bo'lardi.


Zamonaviy alternativa: react-error-boundary

O'zingiz class component yozishni istamasangiz, React jamoasi tomonidan keng tavsiya etiladigan tayyor paketdan foydalanishingiz mumkin:

npm install react-error-boundary
import { ErrorBoundary } from 'react-error-boundary';

function ErrorFallback({ error, resetErrorBoundary }: any) {
  return (
    <div role="alert">
      <p>Nosozlik: {error.message}</p>
      <button onClick={resetErrorBoundary}>Qayta sinash</button>
    </div>
  );
}

<ErrorBoundary FallbackComponent={ErrorFallback}>
  <BuggyProfile />
</ErrorBoundary>

Xulosa

Error Boundaries — bu ilovaning mustahkamligi (resilience) va professional sifatini belgilovchi eng muhim arxitekturaviy vositalardan biridir. Har bir mustaqil bo'limni alohida Error Boundary bilan o'rash orqali kutilmagan dasturchi yoki API xatolarining butun dasturni to'xtatib qo'yishiga yo'l qo'ymaysiz.