الانتقال إلى المحتوى الرئيسي
عندما يعجز الشرط والتقسيم الجاهزان عن التعبير عن منطقك، تكتب خطوة كود. إجراء دالة JavaScript ينفّذ كوداً حقيقياً داخل المسار بمعاملات دخل ومخرجات تربطها بالخطوات التالية. يشرح هذا الدليل الحقول وحدود الاستخدام الآمن.

بطاقة سريعة

عندما يعجز الشرط والتقسيم الجاهزان عن التعبير عن منطقك، تكتب كوداً. هذا الإجراء ينفّذ JavaScript حقيقياً كخطوة كاملة الصلاحية داخل المسار — لا مجرد تعبير حسابي بسيط.

الحقول

محرر دالة JavaScript مفتوحاً بكود بسيط (مثال: تحويل تاريخ لصيغة نصية)، مع معامل دخل واحد وربط مخرج واحد.

محرر دالة JavaScript مفتوحاً بكود بسيط (مثال: تحويل تاريخ لصيغة نصية)، مع معامل دخل واحد وربط مخرج واحد.

معاملات الدخل: القيمة الحقيقية وقيمة الاختبار

كل معامل يقبل متغيراً ديناميكياً من المسار (بيانات العميل، إجابة سؤال سابق، نتيجة إجراء سابق)، بالإضافة إلى قيمة اختبار مستقلة تُستخدم فقط عند تجربة الكود أثناء البناء — دون التأثير على القيمة الحقيقية المستخدمة عند التشغيل الفعلي.
استخدم قيم اختبار قريبة من الحالات الحدّية الحقيقية (نص فارغ، رقم سالب، تاريخ غير صالح) لا فقط حالة “الطريق السعيد” — هذا يكشف أخطاء الكود قبل أن يكشفها عميل حقيقي.

ربط المخرجات

بعد تنفيذ الكود، تحتاج أن تحدد أي قيمة من نتيجته تريد الاحتفاظ بها لاستخدامها في خطوات لاحقة (شرط، رسالة، طلب HTTP آخر). لكل مخرج تربطه:
  1. القيمة المصدر: اسم المتغيّر أو الحقل في نتيجة الكود.
  2. الحقل الهدف: أين تُحفظ — حقل على بطاقة العميل، أو متغيّر مسار عادي.
  3. قيمة افتراضية عند الفشل: تُستخدم إن فشل تنفيذ الكود أو لم يُرجع القيمة المتوقعة، بحيث لا يتوقف المسار بقيمة فارغة غير متوقعة.

متى تستخدمه؟

لا تكتب منطقاً بسيطاً (مثل “أكبر من ١٠٠”) في كود JavaScript إن كان الشرط يكفي — الشرط أسهل للفريق غير التقني أن يقرأه ويعدّله لاحقاً. استخدم الكود فقط عندما يتجاوز المنطق ما تعبّر عنه العقد الجاهزة.

أخطاء شائعة

الخطوة التالية

تعلّمت دالة JavaScript. بعد ذلك:

ذات صلة

آخر تعديل في ٩ أغسطس ٢٠٢٦