TypeScript Tutorial فصل ۵ — ابزارهای پیشرفته درس آموزشی

TypeScript و DOM — چک انواع در مرورگر

وقتی با DOM کار می‌کنید، querySelector می‌تواند هر المانی باشد یا null. TS شما را مجبور می‌کند قبل از استفاده چک کنید — همین سخت‌گیری جلوی کرش‌های null در مرورگر را می‌گیرد. با selector دقیق مثل #app یا button.btn، TS نوع دقیق المان را هم حدس می‌زند.

مراحل قدم‌به‌قدم

  1. ۱

    چک null اجباری

    const btn = document.querySelector('#send'); با strict، استفاده مستقیم btn.addEventListener خطا می‌گیرد چون می‌تواند null باشد. الگو: if (!btn) return; یا if (btn === null) throw new Error().

  2. ۲

    نوع دقیق با selector

    document.querySelector<HTMLInputElement>('.email') به TS می‌گوید این المان input است؛ حالا value در دسترس است (روی HTMLElement عمومی value وجود ندارد).

  3. ۳

    addEventListener با نوع رویداد

    btn.addEventListener('click', (e) => { … }) — e از نوع MouseEvent است و preventDefault دارد. برای input از 'input' و e.currentTarget استفاده کنید و در صورت نیاز تبدیل نوع بدهید.

  4. ۴

    تبدیل امن و 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

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

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

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

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

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

کپچا

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