TypeScript Tutorial فصل ۳ — ساختارهای داده و توابع درس آموزشی

Union و Literal Types — «یا» در دنیای نوع‌ها

Union یعنی «نوع اول یا نوع دوم»: string | number برای مقداری که می‌تواند هر دو باشد (مثل شناسه که گاهی عدد است و گاهی رشته). Literal Type نوع را به مقادیر مشخص محدود می‌کند: 'pending' | 'approved' | 'rejected'. این دو در ترکیب با هم، جایگزین حرفه‌ای enum و راهنمای بسیار قوی در ادیتور هستند.

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

  1. ۱

    اعلام و استفاده از union

    let id: string | number = 12; با چک typeof: if (typeof id === 'string') { id.toUpperCase(); } بعد از چک، داخل بلوک TS فقط رفتار رشته را می‌پذیرد — این قابلیت Narrowing نام دارد.

  2. ۲

    Literal types — مقادیر محدود

    type Status = 'draft' | 'published' | 'trash'; متغیر status فقط این سه مقدار را می‌پذیرد. تایپ اشتباه 'publish' در ادیتور خطا می‌گیرد و ادیتور پیشنهاد سه مقدار مجاز را نشان می‌دهد — دقیقاً همان‌جایی که باگ وضعیت‌ها متولد می‌شد.

  3. ۳

    Type Alias — نام‌گذاری نوع

    کلیدواژه type یک نام برای نوع می‌سازد: type ID = string | number; خوانایی و استفاده مجدد بالا می‌رود. type با اینترفیس تفاوت‌های ظریف دارد؛ برای ترکیب union‌ها type بهتر است.

  4. ۴

    کاربرد ترکیبی در توابع

    function formatPrice(v: number | string): string { return typeof v === 'number' ? v.toLocaleString('fa-IR') : v; } پارامترهای پذیرا اما امن — الگویی که در کتابخانه‌های واقعی هزار بار تکرار می‌شود.

نکات مهم

  • ◆ بعد از هر چک typeof، TS نوع را باریک می‌کند — از این قابلیت همه‌جا استفاده کنید.
  • ◆ برای حالت‌های وضعیت (status) حتماً Literal Type بسازید، نه رشته آزاد.
  • ◆ type ID = string | number خواناتر از تکرار union در ده‌ها جای کد است.

کد یا مسیر نمونه

type Status = "draft" | "published" | "trash";
type ID = string | number;

let post: { id: ID; status: Status } = { id: 101, status: "draft" };

function renderId(id: ID): string {
  if (typeof id === "number") return `#${id}`;
  return id.toUpperCase(); // اینجا TS می‌داند رشته است
}

post.status = "published";   // مجاز
// post.status = "publish";  // خطا — لیترال مجاز نیست
console.log(renderId(post.id));

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

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

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

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

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

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

کپچا

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