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

في بعض الأحيان، لا يكون نوع واحد كافيًا. قد يصل مُعرّف المستخدم كـ "user123" أو كـ 42. في لغة Lua العادية، قد تتأمل خيرًا فحسب؛ ولكن Luau تمنحك أنواع Union — والرمز | يُقرأ كـ "أو":

local userId: number | string

userId = "user123"  -- ✓ يُسمح بـ string
userId = 42          -- ✓ يُسمح بـ number
userId = true        -- ✗ خطأ نوع: boolean ليس في الـ union

يمكن لـ variable أن تحمل أيًا من members الـ union — وتلك فقط. هذا هو الفارق الجوهري عن any: تظل الـ union صارمة بشأن ما هو مسموح به مع منحك المرونة التي تحتاجها.

تُعد أنواع الـ union مفيدة بشكل خاص لـ parameter الخاص بـ function والتي تقبل أشكالاً متعددة من المدخلات:

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

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

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