Seriya: React Basics Dars 72

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?

  1. 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.
  2. Imlo xatolaridan to'liq himoya:
    • Agar siz adashib user.emial yoki user.first_name deb yozsangiz, TypeScript darhol qizil to'lqinli chiziq bilan xatolikni ko'rsatadi va dasturni ishga tushirishga yo'l qo'ymaydi.
  3. 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 UserResponse deb 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, Address va UserResponse ko'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.