فصل ۱ — شروع TypeScript
TypeScript چیست و چرا به آن نیاز داریم؟ نصب TypeScript و اجرای اولین فایل tsconfig.json — تنظیمات سختگیرانه پروژهفصل ۲ — انواع داده (Types)
انواع پایه: string، number و boolean any، unknown، void و never — چهار نوع ویژهفصل ۳ — ساختارهای داده و توابع
آرایهها، تاپلها و پیمایش امن Union و Literal Types — «یا» در دنیای نوعها توابع: پارامتر، خروجی و پارامترهای اختیاریفصل ۴ — اینترفیس و کلاس
اینترفیس — قرارداد شکل آبجکتها کلاسها با access modifiers و implementsفصل ۵ — ابزارهای پیشرفته
ژنریکها — توابع و نوعهای پارامتری TypeScript و DOM — چک انواع در مرورگر کار با API: fetch، async و نوع پاسخپروژه عملی پایان دوره
پروژه پایانی ۱ — مدیریت کارها (Todo) تایپشده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی APIپروژه پایانی ۲ — داشبورد کاربران با داده واقعی API
پروژه پایانی دوم: صفحهای که لیست کاربران را از API واقعی JSONPlaceholder میگیرد، با جستجوی زنده فیلتر میکند و با یک جدول تایپشده نمایش میدهد — شبیهسازی کوچک همان کاری که در پروژههای فرانت واقعی هر روز میکنید.
راهحل قدمبهقدم پروژه
-
۱
هدف پروژه
واکشی داده از https://jsonplaceholder.typicode.com/users، ساخت جدول با جستجوی زنده و مدیریت کامل خطا، همه با TypeScript و بدون any.
-
۲
الزامات و موارد موردنیاز
اتصال اینترنت برای تست (یا فایل JSON محلی بهعنوان جایگزین)؛ آشنایی با fetch و DOM؛ TS strict.
-
۳
قدم ۱ — اینترفیس داده API
بر اساس ساختار پاسخ JSONPlaceholder اینترفیس User بسازید: id، name، username، email، phone و آدرس تو در تو (address.city). اینترفیس آشیانهای یعنی address: { city: string; … }
-
۴
قدم ۲ — تابع واکشی امن
تابع loadUsers(): Promise<User[]> بنویسید که res.ok را چک کند و پاسخ را با as User[] تبدیل کند. خطاهای شبکه را با try/catch بگیرید و پیام فارسی نمایش دهید.
-
۵
قدم ۳ — جدول با DOM بسازید
داده را در tbody رندر کنید: برای هر کاربر tr با سه ستون نام، ایمیل و شهر بسازید. از createElement استفاده کنید نه innerHTML — خروجی API هرگز مستقیم در HTML جایگذاری نمیشود.
-
۶
قدم ۴ — جستجوی زنده
یک input برای جستجو بگذارید و در رویداد input، آرایه را با filter فیلتر کنید (مطابقت در name و email) و دوباره رندر کنید. تابع render را از واکشی جدا نگه دارید تا بدون داده تکراری رندر ممکن شود.
-
۷
قدم ۵ — حالتهای بارگذاری و خطا
قبل از واکشی متن «در حال بارگذاری…»، بعد از آن جدول و در خطا پیام دوستانه نمایش دهید. شمارنده «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
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
خروجی مورد انتظار
با اینترنت: جدول ۱۰ کاربر JSONPlaceholder رندر میشود. با تایپ «L» در جستجو، فقط کاربران دارای L در نام یا ایمیل میمانند و شمارنده بهروز میشود. بدون اینترنت: پیام فارسی خطا نمایش داده میشود.
چالش اضافه (اختیاری)
مرتبسازی ستونی بر اساس کلیک روی عنوان جدول و ذخیره آخرین جستجو در localStorage اضافه کنید.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!