تعدادات النصوص كاتحادات (Unions)

الأرقام تجعل السجلات الغامضة صعبة الفهم: رؤية 2 لا تخبرك بالكثير، أما رؤية "down" فتخبرك بكل شيء. للحصول على enums قابلة للقراءة، تُعد literal union types في Luau الأداة المناسبة: نوع تكون أعضاؤه strings دقيقة:

type Direction = "up" | "down" | "left" | "right"

local facing: Direction = "up"    -- ✓
local typo: Direction = "upp"     -- ✗ خطأ في النوع أثناء التحرير

يمكن لمتغير annotated بـ Direction أن يحتوي على تلك السلاسل الأربعة four strings ولا شيء آخر. أخطئ في تهجئة إحداها، وسيلتقطها المدقق فورًا: لن يصل الخطأ أبدًا إلى player.

في runtime، تكون القيم plain strings. اطبعها، أو ادمجها، أو قارنها باستخدام ==. كل ما تعرفه عن strings ينطبق هنا:

print(facing)            -- أعلى
print(`facing {facing}`) -- مواجه للأعلى

قارن بين النمطين اللذين أصبحا لديك الآن: ينشئ الجدول الثابت قيمة واحدة في runtime (UserRole) تحتوي على أعضاء، بينما لا ينشئ literal union أي قيمة على الإطلاق. لا يوجد جدول Direction، بل rule فقط يفرضه المدقق بشأن strings التي تلائم النوع. إن القيم الوصفية التي تشرح نفسها بنفسها، مع انعدام تكلفة runtime، تجعل literal unions أسلوب enum المفضل في شيفرة Luau.