فصل ۱ — شروع 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) تایپشده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی APITypeScript و DOM — چک انواع در مرورگر
وقتی با DOM کار میکنید، querySelector میتواند هر المانی باشد یا null. TS شما را مجبور میکند قبل از استفاده چک کنید — همین سختگیری جلوی کرشهای null در مرورگر را میگیرد. با selector دقیق مثل #app یا button.btn، TS نوع دقیق المان را هم حدس میزند.
مراحل قدمبهقدم
-
۱
چک null اجباری
const btn = document.querySelector('#send'); با strict، استفاده مستقیم btn.addEventListener خطا میگیرد چون میتواند null باشد. الگو: if (!btn) return; یا if (btn === null) throw new Error().
-
۲
نوع دقیق با selector
document.querySelector<HTMLInputElement>('.email') به TS میگوید این المان input است؛ حالا value در دسترس است (روی HTMLElement عمومی value وجود ندارد).
-
۳
addEventListener با نوع رویداد
btn.addEventListener('click', (e) => { … }) — e از نوع MouseEvent است و preventDefault دارد. برای input از 'input' و e.currentTarget استفاده کنید و در صورت نیاز تبدیل نوع بدهید.
-
۴
تبدیل امن و Type Guard
برای تبدیل صریح از as استفاده کنید اما بدانید as یعنی «من مطمئنم» — اگر مطمئن نیستید، چک کنید: if (el instanceof HTMLInputElement) { … } این چک هم امنتر است هم خواناتر.
نکات مهم
- ◆ querySelector خودش null میدهد؛ استفاده بدون چک با strict خطای کامپایل است.
- ◆ برای المانهای خاص از ژنریک selector استفاده کنید: <HTMLInputElement>.
- ◆ instanceof چک امنتر از as است چون در runtime هم درست کار میکند.
کد یا مسیر نمونه
const btn = document.querySelector<HTMLButtonElement>("#send");
const email = document.querySelector<HTMLInputElement>("input.email");
btn?.addEventListener("click", (e: MouseEvent) => {
e.preventDefault();
if (!email) return;
const value = email.value.trim();
if (value === "") {
email.classList.add("is-invalid");
return;
}
console.log(`ایمیل ثبت شد: ${value}`);
email.value = "";
});
اجرای زنده کد JavaScript
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!