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 (
useCatchkabi) 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:
- 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.
- 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.