تجميد الجداول الثابتة

الجدول الثابت (constant table) يحتوي على نقطة ضعف واحدة: أنه لا يزال جدولًا عاديًا. يمكن لأي كود، في أي مكان، أن يقوم بـ UserRole.Admin = 99 — وتتوقف "الثوابت" لديك بهدوء عن كونها ثوابت.

تُغلق Luau هذه الفجوة مع table.freeze. تجعل التجميد (Freezing) الجدول للقراءة فقط أثناء وقت التشغيل (read-only at runtime): أي attempt لإضافة، تغيير، أو إزالة حقل تثير error. النمط المتبع (idiom) هو freeze الـ table في المكان الذي يتم فيه إنشاؤه مباشرة — يُرجع table.freeze نفس الـ table، جاهزًا للتعيين:

local Color = table.freeze({
    Red = 1,
    Green = 2,
    Blue = 3,
})

print(Color.Red) -- 1: القراءة تعمل كالمعتاد
Color.Gold = 4   -- ✗ خطأ: محاولة تعديل جدول للقراءة فقط

على عكس كل شيء آخر في هذه الدورة حتى الآن، هذه حماية أثناء وقت التشغيل (runtime) — error حقيقي في اللحظة التي تنفذ فيها الـ write، وليس تحذيرًا أثناء التحرير. إنها تحمي حتى ضد الكود الذي لم يره فاحص الأنواع (type checker) مطلقًا.

مرفقان يستحقان المعرفة: يُرجع table.isfrozen(t) ما إذا كان الـ table frozen أم لا، والتجميد يكون سطحيًا (shallow) — تظل الجداول المتداخلة قابلة للتعديل ما لم تقم بـ freeze لها أيضًا. كما لا يمكنك إلغاء التجميد: بمجرد أن يصبح frozen، يظل الـ table frozen.

جدول الثوابت الـ frozen بالإضافة إلى literal union للمعلمات هو enum Luau الكامل: قيم مسماة في وقت التشغيل لا يمكن لأحد العبث بها، وفحص في وقت التحرير في كل مكان تُستخدم فيه.