متى تستخدم هذه الدوال؟
فضّل شرطاً قصيراً وصريحاً على تعبير متداخل طويل. قيّم القيم الفارغة وnull بوضوح قبل استخدام النتيجة لتغيير حالة أو قرار توجيه أو مخرج عام.طريقة الكتابة
استخدم الدالة بصيغةbetween($.requested_amount, 1000, 10000). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
andFn
تجمع نتيجتين بمنطق «و» وتعيد قيمة منطقية.
التوقيع: andFn(left, right)
مثال:
value | andFn(...).
between
تتحقق من وقوع قيمة رقمية أو قابلة للمقارنة ضمن حدين شاملين. هذه هي الدالة الفعالة بعد حل تعارض التسجيل.
التوقيع: between(value, minimum, maximum)
مثال:
value | between(...).
coalesce
تعيد أول قيمة ليست null من القيم المعطاة.
التوقيع: coalesce(first, fallback)
مثال:
value | coalesce(...).
defaultTo
تعيد أول قيمة ليست null أو undefined؛ لا تستبدل النص الفارغ.
التوقيع: defaultTo(...values)
مثال:
value | defaultTo(...).
eq
تقارن قيمتين بمساواة غير صارمة تسمح بتحويل النوع.
التوقيع: eq(left, right)
مثال:
value | eq(...).
equalsAll
تتحقق من أن كل المرشحين متساوون مع القيمة المرجعية.
التوقيع: equalsAll(value, ...candidates)
مثال:
value | equalsAll(...).
equalsAny
تتحقق من تطابق القيمة المرجعية مع أي مرشح معطى.
التوقيع: equalsAny(value, ...candidates)
مثال:
value | equalsAny(...).
gt
تتحقق من أن القيمة الأولى أكبر من الثانية.
التوقيع: gt(left, right)
مثال:
value | gt(...).
gte
تتحقق من أن القيمة الأولى أكبر من الثانية أو مساوية لها.
التوقيع: gte(left, right)
مثال:
value | gte(...).
hasProperty
تتحقق من وجود خاصية مسماة في كائن.
التوقيع: hasProperty(value, property)
مثال:
value | hasProperty(...).
ifElse
تعيد إحدى قيمتين وفق نتيجة شرط.
التوقيع: ifElse(condition, whenTrue, whenFalse)
مثال:
value | ifElse(...).
inOp
تتحقق من وجود قيمة ضمن نص أو قائمة.
التوقيع: inOp(value, collection)
مثال:
value | inOp(...).
inRange
تتحقق من وقوع قيمة ضمن واحد أو أكثر من النطاقات الشاملة [minimum, maximum].
التوقيع: inRange(value, ...ranges)
مثال:
value | inRange(...).
instanceOf
تتحقق من كون قيمة مثيلاً لمنشئ يزوده سياق التقييم صراحةً.
التوقيع: instanceOf(value, constructor)
مثال:
value | instanceOf(...).
isNotNull
تتحقق من وجود قيمة وعدم كونها null أو undefined.
التوقيع: isNotNull(value)
مثال:
value | isNotNull(...).
isNull
تتحقق من كون القيمة null أو undefined.
التوقيع: isNull(value)
مثال:
value | isNull(...).
isType
تتحقق من نوع JavaScript للقيمة بالاسم المعطى.
التوقيع: isType(value, type)
مثال:
value | isType(...).
like
يطابق النص مع نمط يستخدم % كحرف بدل، دون حساسية لحالة الأحرف.
التوقيع: like(value, pattern)
مثال:
value | like(...).
lt
تتحقق من أن القيمة الأولى أصغر من الثانية.
التوقيع: lt(left, right)
مثال:
value | lt(...).
lte
تتحقق من أن القيمة الأولى أصغر من الثانية أو مساوية لها.
التوقيع: lte(left, right)
مثال:
value | lte(...).
ne
تتحقق من عدم مساواة قيمتين بمقارنة غير صارمة.
التوقيع: ne(left, right)
مثال:
value | ne(...).
not
تعكس القيمة الصادقة أو الكاذبة بمنطق النفي.
التوقيع: not(value)
مثال:
value | not(...).
notEqualsAny
تتحقق من اختلاف القيمة المرجعية عن كل المرشحين المعطاة.
التوقيع: notEqualsAny(value, ...candidates)
مثال:
value | notEqualsAny(...).
notIn
تتحقق من عدم وجود القيمة ضمن نص أو قائمة.
التوقيع: notIn(value, collection)
مثال:
value | notIn(...).
notLike
تتحقق من عدم مطابقة النص لنمط % دون حساسية لحالة الأحرف.
التوقيع: notLike(value, pattern)
مثال:
value | notLike(...).
orFn
تجمع نتيجتين بمنطق «أو» وتعيد قيمة منطقية.
التوقيع: orFn(left, right)
مثال:
value | orFn(...).
regex
يطابق نصاً مع تعبير نمطي ويمكنه استقبال أعلام التعبير.
التوقيع: regex(value, pattern, flags)
مثال:
value | regex(...).
safeGet
يقرأ خاصية متداخلة دون رمي خطأ عند غياب قيمة في المسار.
التوقيع: safeGet(value, path)
مثال:
value | safeGet(...).
strictEq
تقارن قيمتين بمساواة صارمة دون تحويل النوع.
التوقيع: strictEq(left, right)
مثال:
value | strictEq(...).
strictNe
تتحقق من عدم مساواة قيمتين بمقارنة صارمة دون تحويل النوع.
التوقيع: strictNe(left, right)
مثال:
value | strictNe(...).
xorFn
تعيد true عندما تكون واحدة فقط من القيمتين صادقة.
التوقيع: xorFn(left, right)
مثال:
value | xorFn(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
