TypeScript Tutorial پروژه عملی پایان دوره پروژه عملی سطح: متوسط

پروژه پایانی ۲ — داشبورد کاربران با داده واقعی API

پروژه پایانی دوم: صفحه‌ای که لیست کاربران را از API واقعی JSONPlaceholder می‌گیرد، با جستجوی زنده فیلتر می‌کند و با یک جدول تایپ‌شده نمایش می‌دهد — شبیه‌سازی کوچک همان کاری که در پروژه‌های فرانت واقعی هر روز می‌کنید.

راه‌حل قدم‌به‌قدم پروژه

  1. ۱

    هدف پروژه

    واکشی داده از https://jsonplaceholder.typicode.com/users، ساخت جدول با جستجوی زنده و مدیریت کامل خطا، همه با TypeScript و بدون any.

  2. ۲

    الزامات و موارد موردنیاز

    اتصال اینترنت برای تست (یا فایل JSON محلی به‌عنوان جایگزین)؛ آشنایی با fetch و DOM؛ TS strict.

  3. ۳

    قدم ۱ — اینترفیس داده API

    بر اساس ساختار پاسخ JSONPlaceholder اینترفیس User بسازید: id، name، username، email، phone و آدرس تو در تو (address.city). اینترفیس آشیانه‌ای یعنی address: { city: string; … }

  4. ۴

    قدم ۲ — تابع واکشی امن

    تابع loadUsers(): Promise<User[]> بنویسید که res.ok را چک کند و پاسخ را با as User[] تبدیل کند. خطاهای شبکه را با try/catch بگیرید و پیام فارسی نمایش دهید.

  5. ۵

    قدم ۳ — جدول با DOM بسازید

    داده را در tbody رندر کنید: برای هر کاربر tr با سه ستون نام، ایمیل و شهر بسازید. از createElement استفاده کنید نه innerHTML — خروجی API هرگز مستقیم در HTML جایگذاری نمی‌شود.

  6. ۶

    قدم ۴ — جستجوی زنده

    یک input برای جستجو بگذارید و در رویداد input، آرایه را با filter فیلتر کنید (مطابقت در name و email) و دوباره رندر کنید. تابع render را از واکشی جدا نگه دارید تا بدون داده تکراری رندر ممکن شود.

  7. ۷

    قدم ۵ — حالت‌های بارگذاری و خطا

    قبل از واکشی متن «در حال بارگذاری…»، بعد از آن جدول و در خطا پیام دوستانه نمایش دهید. شمارنده «X کاربر یافت شد» را هم به‌روز کنید.

نکات مهم

  • ◆ قبل از خواندن راه‌حل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق می‌افتد.
  • ◆ راه‌حل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
  • ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیق‌تر می‌کند.

کد کامل راه‌حل پروژه

interface Address { city: string; }
interface User {
  id: number;
  name: string;
  email: string;
  address: Address;
}

async function loadUsers(): Promise<User[]> {
  const res = await fetch("https://jsonplaceholder.typicode.com/users");
  if (!res.ok) throw new Error(`خطای HTTP: ${res.status}`);
  return (await res.json()) as User[];
}

let users: User[] = [];
let query = "";

function render(): void {
  const tbody = document.querySelector<HTMLTableSectionElement>("#tbody");
  const counter = document.querySelector<HTMLParagraphElement>("#counter");
  if (!tbody) return;
  const rows = users.filter((u) =>
    u.name.toLowerCase().includes(query) || u.email.toLowerCase().includes(query)
  );
  tbody.innerHTML = "";
  for (const u of rows) {
    const tr = document.createElement("tr");
    tr.innerHTML = `<td>${u.name}</td><td dir="ltr">${u.email}</td><td>${u.address.city}</td>`;
    tbody.appendChild(tr);
  }
  if (counter) counter.textContent = `${rows.length} کاربر یافت شد`;
}

async function start(): Promise<void> {
  const status = document.querySelector<HTMLParagraphElement>("#status");
  try {
    users = await loadUsers();
    if (status) status.textContent = "";
    render();
  } catch (err: unknown) {
    if (status) status.textContent = "بارگذاری ناموفق بود — اتصال اینترنت را چک کنید.";
    console.error(err);
  }
}

document.querySelector<HTMLInputElement>("#search")?.addEventListener("input", (e) => {
  query = (e.currentTarget as HTMLInputElement).value.trim().toLowerCase();
  render();
});

start();

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

خروجی مورد انتظار

با اینترنت: جدول ۱۰ کاربر JSONPlaceholder رندر می‌شود. با تایپ «L» در جستجو، فقط کاربران دارای L در نام یا ایمیل می‌مانند و شمارنده به‌روز می‌شود. بدون اینترنت: پیام فارسی خطا نمایش داده می‌شود.

چالش اضافه (اختیاری)

مرتب‌سازی ستونی بر اساس کلیک روی عنوان جدول و ذخیره آخرین جستجو در localStorage اضافه کنید.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.