أنواع الاتحاد (Union Types)

في بعض الأحيان لا يكون type واحد كافياً. قد يصل معرّف المستخدم كـ "user123" أو كـ 42. في Lua العادية كنت تتأمل الخير فقط؛ لكن Luau تمنحك أنواع union (union types) — العلامة | تقرأ كـ "أو":

local userId: number | string

userId = "user123"  -- ✓ يُسمح بـ string
userId = 42          -- ✓ يُسمح بـ number
userId = true        -- ✗ type error: boolean ليس في الـ union

يمكن للـ variable أن يحمل أي عضو من الـ union — وهؤلاء فقط. هذا هو الاختلاف الجوهري عن any: تظل الـ union صارمة بشأن ما هو مسموح به مع إعطائك المرونة التي تحتاجها.

تعتبر الـ types من نوع union مفيدة بشكل خاص لـ parameter الـ function التي تقبل صيغ إدخال متعددة:

function printId(id: number | string): ()
    print(id)
end

printId(42)          -- يعمل مع رقم
printId("user123")   -- يعمل مع سلسلة

أنت تعرف بالفعل string? — لقد كانت هذه أول union لك! هي ببساطة اختصار لـ string | nil. في الدرس القادم ستتعلم كيفية العمل بأمان مع قيمة union بمجرد حصولك عليها.