توضيحات أشكال الجداول المضمنة

في Lua، كنت تستخدم السجلات table منذ وقت طويل: local user = {name = "Ana", age = 20}. لا شيء يمنعك من كتابة اسم حقل بشكل خاطئ، أو نسيان أحد الحقول، أو تخزين string حيث يجب أن تكون number. لن تعرف ذلك إلا عند تشغيل الكود.

يتيح لك Luau وصف shape الخاص بمثل هذا الجدول مباشرةً في التصريح، مع إدراج كل حقل ونوعه بين الأقواس المعقوفة:

local user: {name: string, age: number} = {
    name = "Ana",
    age = 20,
}

قارن ذلك بأنواع table التي تعرفها بالفعل: يصف {number} مصفوفة، ويصف {[string]: number} خريطةً تحتوي على أي مفاتيح من نوع string. يكون shape أكثر دقة. فهو يسمّي كل حقل على حدة ويمنح كل حقل نوعه الخاص.

بمجرد التصريح عن shape، يتحقق مدقق الأنواع من توافق table معه أثناء التحرير. ويتم الإبلاغ عن الحقل المفقود أو نوع القيمة الخاطئ قبل تشغيل الكود أصلًا:

local user: {name: string, age: number} = {
    name = "Ana",
    age = "twenty", -- ✗ خطأ في النوع: string ليس number
}

وكالعادة، لا تضيف التعليمة التوضيحية أي سلوك أثناء التشغيل: إن table عبارة عن جدول Lua عادي. تُعد أشكال shape المضمّنة مثالية للبنى التي تستخدمها مرة واحدة ولا تخطط لإعادة استخدامها؛ في الدرس التالي ستمنح الأشكال اسمًا.