API response typing — Backend’dan keladigan ma’lumotlarni TypeScript’da tavsiflash
React va TypeScript'da API javoblarini tiplashtirish, ichma-ich obyektlar (nested types), IntelliSense afzalligi va any xavfidan qochish.
72-dars
API response typing — Backend’dan keladigan ma’lumotlarni TypeScript’da tavsiflash
React va TypeScript loyihalarida serverdan (REST API) ma'lumotlarni qabul qilib olayotganda, eng birinchi va hal qiluvchi vazifa — bu ma'lumotlarning aniq tuzilishini (type / interface) belgilab olishdir. Agar ma'lumotlarga shunchaki any deb yozib ketilsa, TypeScript'ning barcha xavfsizlik va avtotugallash imkoniyatlari yo'qqa chiqadi.
API Response Typing nima uchun shart?
- IntelliSense va Avtotugallash:
- Kod yozayotgan paytda IDE (VS Code) obyekt ichida qanday kalitlar mavjudligini (
user.address.city) nuqta qo'yganingiz zahoti taklif qiladi. Qo'lda yodlab yurish yoki server dokumentatsiyasiga qayta-qayta qarashga hojat qolmaydi.
- Kod yozayotgan paytda IDE (VS Code) obyekt ichida qanday kalitlar mavjudligini (
- Imlo xatolaridan to'liq himoya:
- Agar siz adashib
user.emialyokiuser.first_namedeb yozsangiz, TypeScript darhol qizil to'lqinli chiziq bilan xatolikni ko'rsatadi va dasturni ishga tushirishga yo'l qo'ymaydi.
- Agar siz adashib
- Kodni oson qayta ishlash (Refactoring):
- Agar backend'dagi maydon nomi o'zgarsa, uni TypeScript tipida bitta joyda o'zgartirishingiz bilan ilovaning qaysi komponentlarida xato chiqqani bir zumda ko'rinadi.
any ishlatish vs Aniq Tiplashtirish
| Mezon | const data: any |
const data: UserResponse[] |
|---|---|---|
| Xatoni aniqlash vaqti | Dastur foydalanuvchida qulaganda (Runtime) | Kod yozilayotgan paytdayoq (Compile-time) |
| Avtotugallash (IntelliSense) | Mutlaqo ishlamaydi ❌ | To'liq va qulay ishlaydi ✅ |
| Ichma-ich obyektlar | data.address.city xavfli (undefined berishi mumkin) |
Har bir qavat tipi kafolatlangan ✅ |
| Kodni qo'llab-quvvatlash | Murakkab, qorong'u quti kabi | O'z-o'zini tushuntiruvchi ochiq hujjat |
[!IMPORTANT] TypeScript faqat tekshiruvchi vosita, u ma'lumotni o'zgartirmaydi! Yodda tuting:
await response.json() as UserResponsedeb yozganingiz bilan, agar backend rostdan ham boshqa tuzilishdagi ma'lumot qaytarsa, TypeScript uni sehrli tarzda to'g'irlab qo'ymaydi. Haqiqiy va o'ta xavfsiz runtime-validatsiya uchun kelajakda Zod kabi schema validatsiya kutubxonalari ishlatiladi.
Kodda qanday ko'rinadi?
Keling, ichma-ich joylashgan murakkab JSON javobini alohida kichik qismlarga bo'lib, toza va modulli tiplashtirish misolini ko'ramiz:
import React, { useState, useEffect } from 'react';
// 1. Eng ichki obyekt uchun alohida tip
type Geo = {
lat: string;
lng: string;
};
// 2. O'rta qatlamdagi obyekt tipi
type Address = {
street: string;
city: string;
geo: Geo; // Boshqa tipni o'z ichiga oladi
};
// 3. Asosiy API javobi tipi
type UserResponse = {
id: number;
name: string;
email: string;
phone: string;
address: Address;
};
export default function ApiTypingDemo() {
// 4. State'ga aniq UserResponse[] massiv tipini beramiz
const [users, setUsers] = useState<UserResponse[]>([]);
const [isLoading, setIsLoading] = useState<boolean>(true);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
const fetchUsers = async () => {
try {
const response = await fetch('https://jsonplaceholder.typicode.com/users');
if (!response.ok) {
throw new Error(`Server xatosi: ${response.status}`);
}
// 5. JSON ma'lumotini aniq tip orqali qabul qilamiz
const data: UserResponse[] = await response.json();
setUsers(data);
} catch (err: unknown) {
if (err instanceof Error) {
setError(err.message);
} else {
setError("Ma'lumotlarni olishda xatolik yuz berdi!");
}
} finally {
setIsLoading(false);
}
};
fetchUsers();
}, []);
if (isLoading) return <p style={{ color: '#2563eb' }}>⏳ Yuklanmoqda...</p>;
if (error) return <p style={{ color: '#ef4444' }}>❌ Xatolik: {error}</p>;
return (
<div style={{ padding: '16px', border: '1px solid #e2e8f0', borderRadius: '8px', maxWidth: '350px' }}>
<h3 style={{ marginTop: 0 }}>API Response Typing</h3>
<ul style={{ paddingLeft: '20px', margin: 0 }}>
{users.slice(0, 3).map((user) => (
<li key={user.id} style={{ marginBottom: '10px', fontSize: '13px' }}>
<strong>{user.name}</strong> ({user.email})
<br />
{/* 💡 TypeScript address.city mavjudligini 100% biladi */}
<span style={{ color: '#64748b', fontSize: '11px' }}>
📍 Shahar: {user.address.city} (Lat: {user.address.geo.lat})
</span>
</li>
))}
</ul>
</div>
);
}
[!TIP] Modulli tiplashtirish qoidasi: Barcha maydonlarni bitta ulkan tip ichiga tiqishtirmang! Yuqoridagi kabi
Geo,AddressvaUserResponseko'rinishida alohida-alohida ajratib yozish kodni ancha toza qiladi va kelajakda boshqa komponentlarda ham qayta ishlatish (reusability) imkonini beradi.
Real hayotiy misol: Bojxona deklaratsiyasi va rasmiy qolip
- Xalqaro yuk jo'natmasi: Chet eldan katta qutida yuk kelayotganda bojxona xodimlari qutini ochishdan oldin uning deklaratsiya qog'ozini (Type / Interface) o'rganadilar.
- Aniq ro'yxat: Deklaratsiyada qutining ichida nechta buyum borligi, har birining vazni, nomi va manzili bandma-band ko'rsatilgan bo'ladi.
- Xatolikning oldini olish: Agar deklaratsiyadagi ma'lumotlar bilan ichidagi buyumlar mos kelmasa, yuk darhol to'xtatiladi.
- TypeScript ham serverdan kelayotgan JSON ma'lumotlarini xuddi shu kabi qat'iy deklaratsiya qolipiga soladi va ilovangizda hech qanday noma'lum yoki kutilmagan obyekt aylanib yurmasligini kafolatlaydi.