Type-safe component API — Keraksiz prop kombinatsiyalarini cheklash va komponent shartlarini turlar bilan ifodalash
React va TypeScript'da xavfsiz komponent interfeyslarini (API) loyihalash, o'zaro istisno qiluvchi (mutually exclusive) proplar, Discriminated Unions va impossible states'larni butunlay yo'q qilish.
81-dars
Type-safe component API — Keraksiz prop kombinatsiyalarini cheklash va komponent shartlarini turlar bilan ifodalash
React loyihalarida komponentlar kengayib borgani sari ularning qabul qiladigan prop'lari soni ham ortib boradi. Ko'pincha dasturchilar yangi talablar paydo bo'lganda, ularni shunchaki ixtiyoriy (? — optional) qilib bitta umumiy interfeysga qo'shib ketaverishadi. Natijada bir-biriga zid yoki umuman mantiqsiz prop kombinatsiyalarini yuborish imkoni paydo bo'ladi.
Type-safe Component API'ning asosiy qoidasi: "Noto'g'ri yoki mantiqsiz holatdagi kodni yozishning o'zini kompilyatsiya vaqtidayoq imkonsiz qilib qo'yish (Make impossible states impossible)."
Muammo: "Hamma narsa ixtiyoriy (Optional)" anti-patterni
Tasavvur qiling, siz universal yuklash tugmasi yoki bildirishnoma komponenti yaratyapsiz. Uning quyidagi holatlari bor:
- Oddiy (Normal): tugma matni va bosish hodisasi (
onClick). - Yuklanish (Loading): spinner va foiz (
progress), lekinonClickkerak emas! - Muvaffaqiyat (Success): havolasi (
url), lekin progress kerak emas!
Agar hamma prop'larni bitta interfeysga solib ? qilsak:
// ❌ YOMON YONDASHUV: Har qanday xato kombinatsiyaga ruxsat beradi
interface BadButtonProps {
variant?: 'normal' | 'loading' | 'success';
label?: string;
onClick?: () => void;
isLoading?: boolean;
progress?: number;
url?: string;
}
// 😱 Mantiqsiz kombinatsiyalar kompilyatordan bemalol o'tib ketadi:
<BadButton variant="normal" progress={80} url="https://example.com" />
Bunday kod yozilganda:
- Komponent ichida 10 lab
if (variant === 'normal' && !progress)kabi xunuk tekshiruvlar yozishga to'g'ri keladi. - Boshqa dasturchi komponentni ishlatayotganda qaysi prop qachon kerakligini bilolmay sarson bo'ladi.
- Run-time (ishga tushish) paytida kutilmagan vizual xatolar yuzaga keladi.
1-Yechim: Discriminated Unions orqali Type-Safe API (Tavsiya etiladi)
Komponentning har bir holati (rejimi) uchun alohida prop turini e'lon qilamiz va ularni umumiy diskriminator (masalan, variant) orqali birlashtiramiz.
1. Umumiy (Base) va Rejimga xos turlarni ajratish
import React from 'react';
// Barcha variantlar uchun umumiy bo'lgan prop'lar
interface BaseButtonProps {
className?: string;
disabled?: boolean;
children?: React.ReactNode;
}
// 1. Oddiy tugma rejimi
interface NormalButtonProps extends BaseButtonProps {
variant: 'normal';
label: string;
onClick: () => void;
}
// 2. Yuklanish rejimi (onClick talab etilmaydi!)
interface LoadingButtonProps extends BaseButtonProps {
variant: 'loading';
loadingText: string;
progress?: number; // 0-100 oralig'ida
}
// 3. Havola (Link) rejimi (onClick o'rniga href majburiy!)
interface LinkButtonProps extends BaseButtonProps {
variant: 'link';
href: string;
target?: '_blank' | '_self';
}
// BARCHASINI UNION QILAMIZ:
export type SafeButtonProps =
| NormalButtonProps
| LoadingButtonProps
| LinkButtonProps;
Komponentni to'liq implementatsiya qilish
Discriminated union ishlatilganda, switch (props.variant) orqali TypeScript har bir blokda aynan qaysi prop'lar mavjudligini 100% aniq biladi (Type Narrowing):
export function SafeButton(props: SafeButtonProps) {
const { className = '', disabled = false } = props;
switch (props.variant) {
case 'normal':
// Bu yerda TypeScript faqat label va onClick borligini biladi!
return (
<button
className={`btn btn-primary ${className}`}
disabled={disabled}
onClick={props.onClick}
>
{props.label}
</button>
);
case 'loading':
// Bu yerda loadingText va progress mavjud, onClick yo'q!
return (
<button className={`btn btn-loading ${className}`} disabled={true}>
<span>⏳ {props.loadingText}</span>
{props.progress !== undefined && <span> ({props.progress}%)</span>}
</button>
);
case 'link':
// Bu yerda href va target bor!
return (
<a
href={props.href}
target={props.target}
className={`btn btn-link ${className}`}
>
{props.children ?? 'Havola'}
</a>
);
default: {
// Yangi variant qo'shilsa-yu case unutilsa, TypeScript xabar beradi
const _exhaustiveCheck: never = props;
return null;
}
}
}
Qanday xatolar oldi olinadi? (Amaliy natija)
Endi dasturchi kod yozayotganda IDE faqat o'sha rejimga ruxsat berilgan prop'larni ko'rsatadi:
function App() {
return (
<div style={{ display: 'flex', gap: '12px' }}>
{/* ✅ To'g'ri: Oddiy rejim */}
<SafeButton
variant="normal"
label="Saqlash"
onClick={() => console.log('Saqlandi')}
/>
{/* ✅ To'g'ri: Yuklanish rejimi */}
<SafeButton
variant="loading"
loadingText="Yuklanmoqda..."
progress={45}
/>
{/* ✅ To'g'ri: Havola rejimi */}
<SafeButton
variant="link"
href="https://google.com"
target="_blank"
>
Saytga o'tish
</SafeButton>
{/* ❌ QIZIL XATOLIK: 'normal' variantida 'loadingText' mavjud emas! */}
{/* <SafeButton variant="normal" label="Test" loadingText="Kuting..." /> */}
{/* ❌ QIZIL XATOLIK: 'link' variantida 'onClick' ruxsat etilmaydi! */}
{/* <SafeButton variant="link" href="/home" onClick={() => {}} /> */}
{/* ❌ QIZIL XATOLIK: 'normal' variantida 'onClick' majburiy, uni tashlab ketolmaysiz! */}
{/* <SafeButton variant="normal" label="Bosish" /> */}
</div>
);
}
2-Yechim: Variant propsiz O'zaro Istisno Qilish (never tipi orqali)
Ba'zida siz qo'shimcha variant="..." propini yozishni istamaysiz. Masalan: agar href berilsa komponent avtomatik havola bo'lsin, agar onClick berilsa oddiy tugma bo'lsin, lekin ikkalasi birdan berilmasin.
Buni never turi orqali amalga oshiramiz:
type ButtonMode = {
onClick: () => void;
href?: never; // href berilishi qat'iyan man etiladi!
};
type LinkMode = {
href: string;
onClick?: never; // onClick berilishi qat'iyan man etiladi!
};
type ActionProps = (ButtonMode | LinkMode) & {
children: React.ReactNode;
};
function ActionButton(props: ActionProps) {
if (props.href) {
return <a href={props.href}>{props.children}</a>;
}
return <button onClick={props.onClick}>{props.children}</button>;
}
// Ishlatilishi:
// ✅ Ruxsat: faqat onClick
<ActionButton onClick={() => alert('Bosildi')}>Tugma</ActionButton>
// ✅ Ruxsat: faqat href
<ActionButton href="/dashboard">Havola</ActionButton>
// ❌ QIZIL XATO: Ikkalasini birga berib bo'lmaydi!
// <ActionButton href="/test" onClick={() => {}}>Xato</ActionButton>
Taqqoslash jadvali
| Xususiyat | Zaif API (Hamma prop optional) | Type-Safe API (Discriminated / Never) |
|---|---|---|
| IntelliSense yordami | Barcha keraksiz prop'larni ham aralashtirib chiqaradi | Faqat joriy rejimga mos prop'larni taklif qiladi |
| Xatoni topish vaqti | Run-time (brauzerda sinab ko'rganda yoki qulaganda) | Compile-time (kodni yozish jarayonida darhol) |
| Komponent ichki kodi | Ko'plab if/else, && va himoya tekshiruvlari talab etiladi |
switch (props.variant) orqali sodda va toza o'qiladi |
| Hujjatlashuv | Props nima qilishini tushunish uchun kod ichini o'qish shart | Turlarning o'zi eng ishonchli hujjat (self-documenting) |
| Buzilish xavfi | Yangi prop qo'shilganda boshqa joylar buzilishi mumkin | Mavjud holatlar xavfsiz va bir-biridan mustaqil qoladi |
Real hayotiy analogiya: Tibbiy Uskunaning Boshqaruv Paneli
Tasavvur qiling, shifoxonadagi bemorni monitoring qiluvchi reanimatsiya apparati bor:
- EKG (Yurak urishi) rejimida: ekranda puls datchigi va yurak grafigi parametrlari ko'rsatiladi.
- Kislorod berish (IVL) rejimida: faqat havo bosimi va daqiqalik oqim tezligi sozlamalari ochiladi.
[!NOTE] Boshqaruv tizimi kislorod berish rejimida turganda yurak elektroshoki (defibrillyatsiya) tugmalarini faollashtirmaydi va yashirib turadi. Bu shifokor adashib boshqa rejimning tugmasini bosib qo'yishining oldini oladi.
Type-safe Component API ham xuddi shunday: komponent qaysi holatda bo'lsa, ishlab chiquvchiga faqat o'sha holatga daxldor bo'lgan xususiyatlarni taqdim etadi!
E'tibor berish kerak bo'lgan muhim qoidalar
[!CAUTION] Props'ni erta destrukturizatsiya qilmang! Discriminated Union ishlatayotganda komponent kirishidayoq prop'larni ajratib olmang:
// ❌ XATO: TypeScript variant va boshqa prop'lar orasidagi bog'liqlikni yo'qotadi function BadComponent({ variant, label, loadingText }: SafeButtonProps) { ... } // ✅ TO'G'RI: Avval butun props obyektini qabul qilib, switch orqali tekshiring function GoodComponent(props: SafeButtonProps) { if (props.variant === 'normal') { return <button>{props.label}</button>; // props.label xavfsiz } }
[!TIP] Agar barcha variantlarda qatnashadigan umumiy xossalar (
className,id,children) bo'lsa, ularni har bir variant ichida takrorlamasdan,BasePropsinterfeysi ochib,& BasePropsorqali ulash tavsiya etiladi.
Xulosa
Komponent API'sini loyihalash — bu shunchaki interfeys yozish emas, balki boshqa dasturchilarga (va kelajakdagi o'zingizga) xato qilishga yo'l qo'ymaydigan mustahkam himoya devorini qurishdir. Discriminated Unions va never turlaridan foydalanish orqali ilovangizni xatolardan holi, o'qilishi oson va professional darajaga ko'tarasiz.