العودة إلى كل المقالات
برمجة وتطوير آخر تحديث: 6 نوفمبر 2026

حقل أبعاد الصورة الفارغ يصبح صفراً: افصل الإدخال الناقص عن الرقم غير المقبول

ثلاث بطاقات قرب إطار خشبي ومسطرة، الأولى فارغة والثانية تحمل 0 والثالثة 1600
ثلاث بطاقات قرب إطار خشبي ومسطرة، الأولى فارغة والثانية تحمل 0 والثالثة 1600.

في سجل التجربة تظهر ثلاث قيم تؤول كلها إلى 0 عند تمريرها مباشرة إلى `Number`. القيمة الأولى نص فارغ، والثانية فراغان، والثالثة النص `"0"`. تبدو متساوية بعد التحويل، لكن تطبيقاً يطلب عرض صورة يحتاج أن يفرق بين حقل لم يُملأ وقيمة كتبها المستخدم وتخالف المجال. إذا بدأت بالتحويل فقد فقدت الدليل الذي يميز الحالتين.

تعالج الدالة `parseDimension` النص قبل أن تحوله إلى عدد. تُبلغ عن نقص الحقل عندما لا يبقى شيء بعد حذف الفراغات الطرفية. ترفض الصفر لأنه خارج مجال المثال، وتقبل `"1600"` وتعيد العدد 1600. شغّلنا التجربة في Node.js 24.13.0. الحدود من 64 إلى 4096 قرار خاص بالمشروع التجريبي، وليست مواصفة لأداة صور أو قاعدة للمتصفح.

تتبع ثلاث حالات قبل أن تعطيها رقماً

ابدأ بالمدخل الخام. إذا كان النص `""`، فلا توجد قيمة مكتوبة. وإذا كان يتكون من فراغين فقط، فإن سياسة هذا المثال تعامله بالطريقة نفسها. أما `"0"` فيحمل رقماً مكتوباً بالفعل. يمكن أن يختلف إجراء الواجهة في هذه الحالات. الحقل الناقص قد يدعو إلى طلب قيمة أو إلى تطبيق قيمة افتراضية معلنة. والحقل الذي يحوي صفراً يستحق رسالة تقول إن الرقم مكتوب لكنه غير مقبول ضمن مجال المشروع.

تستعمل `brokenDimension` تعبيراً واحداً هو `Number(raw)`. حفظنا مخرجات ثماني حالات. النص الفارغ والفراغان والصفر المكتوب أعطت 0 في المسار المعطوب. في المسار المصحح أعطى النصان الأولان `RangeError` برسالة `Missing dimension`، بينما أعطى الصفر رسالة `Dimension outside application bounds` من الفئة نفسها. وجود الرسالتين يسهل معرفة أي قرار اتخذته الدالة من دون الاستدلال عليه من القيمة 0.

يحوّل Number النص الفارغ أو المؤلف من فراغات فقط إلى صفر. MDN JavaScript Number reference

افترض أن مشروعاً يستعمل أبعاداً افتراضية عند إنشاء صورة جديدة. إذا كان العرض ناقصاً عن قصد، قد يعرض المشروع القيمة الافتراضية قبل التشغيل. إذا كتبت صفراً، ينبغي أن يعرف التطبيق أنك أدخلت شيئاً حتى لو كانت القيمة غير مقبولة. معالجة الحالتين بمجرد تعويض كل 0 بالافتراضي قد تجعل سجل المشروع يوحي بأنه قبل ما كتبته. اختَر قاعدة التعويض في طبقة تعرف سياق الإدخال. الدالة المحلية ترفض النص الناقص وتترك اختيار الخطوة التالية للمستدعي.

قد يُستخدم نفس الحقل لتحرير مشروع قديم. حين يمسح المحرر الرقم ويغادر الحقل، قد يريد أن يستعيد قيمة تلقائية أو قد يكون في منتصف تحريره. من المفيد أن تفرق واجهة مقترحة بين النص الجاري تحريره وبين القيمة التي تعتمد عند الحفظ. يمكنها السماح للنص أن يبقى فارغاً مؤقتاً، ثم طلب رقم عند الالتزام بالتغيير. لم نختبر أحداث واجهة في Node. ما اختبرناه هو القرار عند تمرير نص محدد إلى الدالة.

اقرأ ترتيب الفحص في الدالة

تبدأ `parseDimension` بفحص `min` و`max`. يجب أن يكونا عددين صحيحين آمنين، وألا يقل الحد الأدنى عن 1 أو يقل الأعلى عن الأدنى. إذا فشل هذا الفحص ترفع الدالة `TypeError` برسالة `Invalid application bounds`. يقع الخطأ هنا في إعداد القاعدة نفسها. في مشروع يأخذ الحدود من إعدادات مشتركة، تستطيع معرفة أن الخلل يحتاج مراجعة الإعداد، حتى لو كان حقل العرض الذي يكتبه المستخدم معقولاً.

بعد ذلك تفحص الدالة نوع `raw`. تتوقع نصاً. العدد 1600 إذا مررته مباشرة ليس المدخل الذي تقبله هذه الدالة، مع أن النص `"1600"` يؤدي إلى العدد نفسه في النهاية. تختبر المجموعة أيضاً رفض `false` و`null` بالفئة `TypeError`. يمنع هذا العقد تحويل أي قيمة واردة ضمنياً إلى عدد قبل أن يعرف المستدعي إن كانت قد جاءت من حقل نصي أو من إعداد مقروء أو من طبقة تتعامل مع أرقام جاهزة.

تزيل `trim()` الفراغات الطرفية ثم يُفحص الفراغ. النص `" 1600 "` مقبول في الاختبار. لا تحذف هذه الخطوة المسافات في منتصف النص. لذلك يبقى ترتيب المراحل مفيداً إذا قررت دعم تنسيقات إدخال أخرى لاحقاً. قد تريد تحويل فاصل عرض محلي أو استقبال كتابة مختلفة للأرقام، لكن تعريف ذلك يجب أن يكون صريحاً. العينة تعتمد صيغة رقمية ضيقة بعد حذف الفراغ الطرفي، لا عملية تخمين لما كان الكاتب يقصده.

بعد فحص النقص، تستخدم الدالة التعبير `/^[0-9]+$/` لقبول رقم عشري واحد أو أكثر من المحارف المحددة. ثم تستعمل `Number(text)` وتتحقق من أن الناتج عدد صحيح آمن ويقع داخل المجال. لهذه المراحل وظائف مختلفة. فحص المحارف يحدد الصيغة التي يقبلها المشروع. التحويل ينتج العدد الذي ستستعمله الشيفرة. فحص الناتج يحمي العقد العددي للمثال حتى لو كان النص كله مؤلفاً من أرقام. لا تختصر المراحل في اختبار واحد على القيمة بعد التحويل إذا كنت بحاجة لمعرفة أي شرط خالفه الإدخال.

قرر الصيغة التي يحق للمستخدم كتابتها

يعطي النص `"1e3"` العدد 1000 في مسار `Number` المباشر. ويعطي النص `"1600.0"` العدد 1600. كلا النصين مرفوض في المسار المصحح، لأن سياسة المثال تقبل محارف عشرية فقط. هذه نتيجة مسجلة في ملف المخرجات. قد ترغب في مشروع مختلف أن تقبل إحدى الصيغتين، لكن اخترها بوصفها صيغة مدعومة واختبر شكلها وحدودها. الرقم الذي يظهر في النهاية لا يوضح وحده لماذا قبل المشروع صيغة ورفض أخرى.

تتحقق مجموعة الاختبار أيضاً من رفض `0x100`، و`+64`، و`-64`، و`Infinity`، و`NaN`. كل واحدة منها تحمل محارف خارج المجال الذي يقبله التعبير. بعضها يستطيع أن يتحول إلى عدد في سياق JavaScript آخر. عند تدريب قارئ على هذا العقد، لا تقدم قائمة الصيغ على أنها سلوك إلزامي في اللغة. إنها اختيار لدالة تريد أن تقرأ بعداً من حقل واضح في مشروع معين.

في المقابل تقبل الدالة `"01600"` ويثبت الاختبار أن القيمة العددية هي 1600. إذا كنت تحفظ النموذج كما كتبه الشخص، قد تحتاج إلى الاحتفاظ بالنص الخام في واجهة التحرير وإرسال العدد الذي قبلته الدالة إلى طبقة الحساب. إعادة عرض الناتج العددي قد تزيل الأصفار الأولية دون أن تغير البعد. اختر هل هذا مرغوب في تطبيقك. في حقل يتوقع معرّفاً نصياً، قد تكون الأصفار جزءاً من القيمة ولا ينبغي استعمال قارئ الأبعاد أصلاً.

في واجهة عربية قد يكتب الشخص أرقاماً بغير المحارف `0` إلى `9` التي يحددها التعبير. الصيغة الحالية لا تعد باستقبال كل طرق كتابة الأعداد. إذا كان دعمها جزءاً من المشروع، اختر سياسة تحويل معلنة قبل تطبيق قارئ الأبعاد. ضع حالات للتمثيلات التي تقبلها وحالة لنص يخلط محارف أو فواصل لا تريد قبولها. يمكن أيضاً عرض المثال المقبول قرب الحقل كي يعرف المستخدم ماذا يتوقع التطبيق. هذه قرارات لاحقة لواجهة محلية، ولم نقس تجربة المستخدم أو ندّع تشغيلها في متصفح.

dimension.mjs

export function brokenDimension(raw){return Number(raw);}

export function parseDimension(raw,{min=64,max=4096}={}){
  if(!Number.isSafeInteger(min)||!Number.isSafeInteger(max)||min<1||max<min)throw new TypeError('Invalid application bounds');
  if(typeof raw!=='string')throw new TypeError('Supply input text');
  const text=raw.trim();
  if(text==='')throw new RangeError('Missing dimension');
  if(!/^[0-9]+$/.test(text))throw new RangeError('Use ASCII decimal digits');
  const value=Number(text);
  if(!Number.isSafeInteger(value)||value<min||value>max)throw new RangeError('Dimension outside application bounds');
  return value;
}

نطاق التحقق المحلي: Fourteen Node test methods for a text-to-dimension application contract only. Number empty/whitespace baseline0, explicit missing/range/type distinctions. Bounds64..4096 are this project policy, not an image-provider specification. ASCII digit grammar, no browser form/DOM/API/UX or performance test.؛ البيئة: v24.13.0 on Windows

اجعل حدود المشروع ظاهرة قبل المعالجة

المجال الافتراضي شامل للطرفين. في الاختبارات تُقبل 64 و4096 ويُرفض 63 و4097. إذا كان المشروع يغير الحد لميزة مختلفة، يمكن تمرير كائن إعدادات. أحد الاختبارات يقبل `"10"` عند تحديد المجال من 1 إلى 20. وفي الاختبار المقابل، ينتج خطأ إعداد عند ضبط الحد الأدنى على 20 والأعلى على 1. قبول الإدخال بعد قراءة هذه القاعدة يوضح الفرق بين خطأ في نص الحقل وخطأ في المجال الذي حدده المطور.

يتحقق `Number.isSafeInteger` بعد التحويل أيضاً. تختبر المجموعة رفض النص `"9007199254740993"`. هذا الإدخال يمر من قاعدة المحارف لأنه يتكون من أرقام فقط، لكن اجتياز الصيغة ليس دليلاً على أن العدد مناسب. في المجال الافتراضي سيرفض أيضاً لأنه أكبر من 4096. لا يزعم الاختبار عزل أثر كل شرط رقمي في تلك الحالة. ما يثبته هو أن الدالة رفضت هذا الإدخال. يمكنك عند توسيع المجال أن تكتب حالات إضافية حول الحدود الفعلية التي يختارها مشروعك.

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

يمكن أن تختلف القواعد بين مشروع يصدّر مصغرات ومشروع يجهز صورة أصلية. حتى لو اختار كلاهما قبول النص `"1600"` نحوياً، قد يختلف نطاقه أو ما ينتظره من الحقل الثاني. احتفظ بأسماء الإعدادات التي تشرح لماذا اختير المجال. إذا كانت الحدود ترتبط بمزود صور، راجع مواصفاته وقت العمل، ثم تحقق من الطلب الفعلي في اختبار منفصل. مجموعة Node لا تستدعي مزوداً، ولا تثبت أن رقماً قبلته الدالة سيُقبل في طلب خارجي.

اقرأ ما تقيسه مجموعة الاختبارات

تضم المجموعة 14 طريقة اختبار. أول طريقتين تثبتان أن النص الفارغ والفراغات يتحولان إلى 0 في الدالة المباشرة. بعدها تختبر المجموعة أن النصين يرفضان برسالة النقص في الدالة المصححة. تقارن حالة الصفر المكتوب نص الرسالة بشرط المجال. هذه المقارنات أهم من جمع الحالات الثلاث تحت توقع `RangeError` فقط. عندما يكون تقرير المستدعي مبنياً على معرفة سبب الرفض، تعطيه الحالات دليلاً على أن الفرق لم يختف.

تختبر مجموعة أخرى قبول `"1600"` وقبول الفراغ الطرفي والأصفار الأولية. ليست كل حالة منها طريقة لتحويل الرقم نفسه فحسب. حالة الفراغ تثبت سياسة التنظيف. وحالة الصفر الأولي تثبت أن المشروع يقبل تلك الصيغة ولا يتعامل معها على أنها معرف ذو طول محدد. ويمكن لنتيجة واحدة أن تبقى 1600 بينما تتغير قواعد النص المقبول. إذا غيرت السياسة، احفظ توقعاً منفصلاً لكل صيغة مهمة بدلاً من التحقق من الناتج المشترك فقط.

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

لإعادة التجربة ضع `dimension.mjs` و`test_dimension.mjs` في مجلد المثال وشغّل مجموعة `node:test` كما يبين السجل. استعمل النصوص التي تظهر في الاختبار قبل إدخال قيم من واجهة. عندما تتغير نتيجة، قارن أولاً النوع الخام ثم النص بعد حذف الفراغ وأخيراً العدد. إذا بدأت من العدد في سجل التطبيق، قد تضطر إلى إعادة إنتاج الإدخال كي تعرف هل كانت القيمة غائبة أم كتبت بصيغة لا يدعمها المشروع.

حافظ على الفرق بعد تسليم العدد إلى التطبيق

تأتي خطوة دمج الإعدادات مع الحفاظ على القيم الصريحة بعد تحديد القيم الصالحة للحقل. فهي تعالج بقاء القيمة عند الدمج، بينما يعالج هذا المثال معنى النص الوارد قبل تخزينه. في تطبيق يستقبل ملف إعدادات وحقلاً قابلاً للتحرير، افحص أين يصبح النص عدداً وأين يقرر التطبيق أي مصدر ينتصر. الفصل بين الخطوتين يتيح لك الإبلاغ عن خطأ في الحقل دون إسقاط قيمة قديمة صالحة من المشروع.

إذا كانت واجهة النموذج ترسل نصاً وخدمة التطبيق تستقبل رقماً في واجهة أخرى، ضع عقداً مناسباً لكل مدخل. قارئ النص الحالي يرفض العدد الجاهز. واجهة تستقبل JSON رقمياً قد تحتاج تحققاً عددياً مباشراً مختلفاً، مع رسالة واضحة لنوع خاطئ. لا تحول كل المدخلات إلى نص على نحو آلي كي تمر في الوظيفة نفسها. هذا قد يخفي خطأ في نوع البيانات التي وعد بها المستدعي. اكتب اختباراً يعبر الحد الذي يستخدمه تطبيقك فعلاً ثم تحقق من القاعدة في الموضع الذي يملك المعلومات اللازمة.

قد ترغب في إظهار رسالة نقص الحقل في الواجهة ثم إعادة فحص القيمة عندما يصل الطلب إلى المعالجة. إذا عُرضت رسالة صحيحة على الشاشة، فهذه نتيجة مستقلة عن قبول الطلب الفعلي في الخدمة. يمكن لخدمة المشروع أن تتحقق من المجال قبل حجز العمل حتى إذا لم يأت الطلب من النموذج المعتاد. أما إذا غُيّر الإعداد المشترك، اختبر أن رسالة خطأ الإعداد تصل إلى السجل الذي يراه المسؤول وأنها لا تُعرض كأن المستخدم أخطأ في كتابة رقمه.

اجعل رسائل الإدخال قابلة للترجمة من دون أن تغير السياسة. الكود المعروض يرجع أخطاء JavaScript برسائل إنجليزية لكي تكون مقارنة الاختبار مباشرة. عند ربطه بواجهة عربية، يمكنك أن تختار رموز أسباب ثابتة وتترجم الرسائل عند العرض. هذا تغيير مقترح في عقد الخطأ، لذلك يحتاج اختباراً يميز النقص والصيغة والمجال قبل ترجمة النص. لا تجعل الواجهة تستنتج أن القيمة ناقصة لمجرد أن كل خطأ في الفئة `RangeError`. الفئة مشتركة بين حالات مختلفة في المثال.

قارن سلوك التحرير وسلوك الحفظ في مشروعك

افترض أن المحرر يسمح بحفظ مشروع غير مكتمل كمسودة. في هذه الحالة قد يريد حفظ النص المؤقت كما هو مع علامة أن الإعداد غير معتمد بعد. عند بدء إنشاء الصورة، يطلب التطبيق قيمة مقبولة في كل حقل. لا داعي لملء العرض بصفر أو تشغيل المهمة كي تثبت أن الحقل ناقص. اختبر مسارين في المشروع الفعلي، أحدهما يحفظ حالة التحرير والآخر يلتزم بقيم التشغيل. في المثال المحلي يُختبر القارئ وحده، لذلك لا نعتبر نجاحه دليلاً على سير الحفظ في التطبيق.

إذا سمح المشروع باشتقاق الارتفاع من العرض، فاختر متى يقع الاشتقاق. يمكن لواجهة مقترحة أن تتأكد أولاً من عرض صالح ثم تقترح ارتفاعاً وفق قالب، أو تترك للمستخدم إدخال القيمتين. حقل ارتفاع فارغ قد يكون مقبولاً في الوضع التلقائي بينما يرفض في الوضع اليدوي. لا تستعمل ناتج `Number('')` لتمييز الوضعين. استعمل الإعداد الذي يحدد وضع الحساب والنص الخام لتقرر ماذا تعرض. بعد الاشتقاق اختبر الناتج وفق قواعد الأبعاد التي يتطلبها المشروع.

وعندما تتبع بلاغاً عن قيمة تغيّرت أثناء التشغيل، احفظ مثالاً صغيراً يذكر النص قبل القراءة، والسبب الذي أعادته الدالة أو العدد الذي قبلته، وأين اختار التطبيق قيمة افتراضية أو تجاوزاً من مصدر آخر. إذا ظهر 0 في النتيجة، ستعرف هل كتبه الشخص فعلاً أو أنتجه التحويل المباشر من نص فارغ. وإذا ظهر رقم صحيح ومع ذلك فشلت المهمة، افحص شروط المعالجة التالية مع المدخل المعروف. وبهذا يبقى سلوك الحقل قابلاً للفحص حتى بعد إضافة خطوات أخرى للمشروع.

اختبر قرار الاستيراد عندما تأتي الأبعاد من مصدرين

لنفترض أن مشروع المعاينة يستورد إعداداً محفوظاً ثم يسمح بتعديله في حقل. قد يحتوي الملف المستورد على عدد 1600 بالفعل. يمكن لطبقة الاستيراد أن تتحقق من العدد وفق عقدها ثم تعرضه كنص في المحرر. إذا طلب المحرر حفظ القيمة مرة أخرى، يقرأ النص وفق عقد الحقل. يمكن للمدخلين أن يعطيا العدد نفسه مع اختلاف طريقة الوصول إليه. اختبار كل طريق على حدة يجعل حالة الفشل أوضح، خاصة إذا مرر أحد المستدعين عدداً إلى الدالة المخصصة للنص.

يمكن أيضاً أن يكون ملف الاستيراد قديماً ويترك العرض غير موجود. لا تفترض أن الخاصية الغائبة في ذلك الملف تعادل النص الفارغ الذي أرسله المحرر. قد تكون الغيبة مقصودة وفق نسخة قديمة من الصيغة. أما الحقل الفارغ في واجهة جديدة فقد يمثل تعديلاً جارياً. إذا كان المشروع يدعم التوافق مع إصدارات قديمة، حدّد سياسة كل نسخة قبل فتح المحرر. تستطيع تجربة ملف قديم وملف جديد يحوي صفراً صريحاً، ثم التحقق من الرسالة والقيمة التي يراها المستخدم في كل حالة. هذا اختبار مقترح للاستيراد، لا نتيجة سجل Node.

قد يأتي التعديل في صيغة نصية واحدة تجمع البعدين مثل `1600 × 900`. هذا النص لا يطابق عقد `parseDimension` التي تستقبل بعداً واحداً فقط. إذا سمح مشروعك به، افصل أولاً البعدين وفق صيغة معلنة ثم تحقق من كل جزء. عند وجود فاصل بلا جزء ثان، أبلغ عن ارتفاع ناقص أو عن صيغة مركبة مرفوضة بحسب العقد الذي اخترته. لا تمرر النص المركب مباشرة إلى `Number` وتحاول استنتاج أي جزء كان مفقوداً من الناتج. تعريف شكل المدخل في المرحلة الأولى يجعل حالات الاختبار التالية محددة.

افترض أن المشروع يحفظ نتيجة نهائية في ملف ثم يعيد فتحه. اختبر أن البعد المكتوب يتفق مع ما اعتمدته المهمة، وليس مع النص الذي بقي في الحقل أثناء التحرير. قد يقبل الحقل النص `"01600"` ويعرضه كما هو، بينما يكتب الملف النهائي العدد 1600. هذا الفرق جائز إذا كان جزءاً من سياسة التطبيق. في الاختبار المقترح قارن القيمة المقبولة قبل الحفظ والقيمة المقروءة بعده، وراجع على حدة ما إذا كانت الواجهة تعيد تنسيق النص. المثال الحالي لا يكتب ملفات إعدادات من إدخال مستخدم.

صمم تجربة استخدام صغيرة من دون تخمين ما حدث في المتصفح

قبل ربط الدالة بحقل، تأكد من شكل القيمة التي تصل إلى المستدعي. قد تعطي طبقة النموذج نصاً، وقد تحول القيمة مبكراً. إذا حولتها، لا تضمن وصول النص الذي تحتاجه قاعدة التمييز بين الفراغ والصفر. راقب القيمة في موضع الاستدعاء باستخدام مشروع تجريبي. امسح الحقل، ثم اكتب فراغاً إن كانت الواجهة تسمح بذلك، ثم اكتب الصفر. قارن النوع والقيمة عند الحد نفسه. بهذه الملاحظة تستطيع معرفة هل تطبق الدالة عقدها أم أن طبقة سابقة حسمت القرار بالفعل.

حدد وقت إظهار الرسالة أيضاً. أثناء كتابة الرقم، قد يكون النص قصيراً ثم يكتمل بعد ضغطة أخرى. الرقم 1 خارج المجال الافتراضي، لكنه قد يكون بداية الرقم 1600. إذا ظهرت رسالة خطأ عند كل ضغطة، ربما تبدو الواجهة وكأنها ترفض إدخالاً لم يكتمل. يمكن للتصميم المقترح أن يحتفظ بحالة التحرير ويشغّل فحص الالتزام عند الحفظ أو عند بدء المهمة. المهم أن تختبر اللحظة التي يعتمد عندها التطبيق العدد، وتراجع هل تظهر رسالة مؤقتة أو رسالة مرتبطة فعلاً بقرار الرفض.

اجعل حالة التحقق من الحقول المتعددة قابلة للفهم. إذا كان العرض صالحاً والارتفاع ناقصاً، ضع الرسالة عند الارتفاع. وإذا كان كل منهما صالحاً منفرداً لكن القالب لا يقبل حاصل الضرب أو نسبة البعدين المطلوبة، فهذه رسالة تتعلق بإعداد الصورة كله. يمكن لاختبار التطبيق أن يتحقق من أن رسالة الحقل الناقص لا تختفي وراء خطأ عام. الدالة الصغيرة تعطي نتيجة لحقل واحد. يحتاج اختيار موضع الرسالة إلى المكوّن الذي يعرف أي حقل مرر إلى الدالة.

يمكنك أيضاً مراجعة ما يحدث عند اللصق من مستند. قد يحتوي النص على فراغ طرفي، وهذا ممثل في اختبار `" 1600 "`. وقد يضم نصاً مثل `1600 px` أو فاصلاً داخل الرقم. سياسة الدالة الحالية تتطلب المحارف العشرية بعد إزالة الفراغ الطرفي. إذا أراد المشروع قبول وحدة مكتوبة أو فاصل، ضع قاعدة تحدد موضعهما وشكلهما واختبرها في طبقة مقصودة. لا تتوقع أن نتيجة قبول الرقم 1600 تكشف طريقة تعامل واجهتك مع كل نص يمكن لصقه فيها.

انقل النتائج إلى سجل يمكن مراجعته

في سجل التطوير، اجعل سبب الرفض نتيجة مستقلة عن القيمة المعتمدة. إذا عرض المشروع رسالة `Missing dimension`، لا يملك عدداً مقبولاً من هذا الحقل. يمكن لطبقة الإعداد أن تقترح قيمة مع بيان أنها افتراضية. وإذا ظهر `Dimension outside application bounds`، يكون النص قد اجتاز مرحلة المحارف والتحويل، لكن الشرط العددي لم يسمح باعتماده. تسجيل هاتين النتيجتين بوضوح يساعد عندما تقارن مشروعين يبدوان متطابقين في الصورة النهائية لكنهما وصلا إلى ذلك عبر قرارات مختلفة.

عند تحديث المجال، احفظ في اختبار المشروع القيم القريبة من الطرفين بدلاً من اعتماد قائمة القيم التي كانت تصلح مع إعداد قديم. قد يبقى 1600 في المجال الجديد فلا يظهر أثر التغيير في فحص يعتمد على حالة وسطية فقط. أعد تشغيل حالات تعبر كل حد، وتحقق من أن إعداد المشروع الذي جرى تشغيله هو المقصود. إذا تغيرت رسالة الفئة العامة وحدها، اقرأ السبب مع المدخل قبل أن تنسب الفرق إلى تحويل JavaScript.

إذا اضطررت إلى مراجعة نتائج معالجتين، احتفظ باسم القالب الذي قدم الحدود إلى كل منهما. فالقيمة 63 مرفوضة وفق المجال الافتراضي هنا، وقد تكون صالحة في مشروع يحدد حداً أدنى أصغر. فرق النتائج عند نفس النص لا يثبت اختلافاً في تحويل اللغة. قد يكون ناتجاً عن قاعدة مختلفة أُرسلت إلى الدالة. قارن المجال الفعلي والنص والسبب معاً في العينة التي تعيد المشكلة. وعندما تعدل نطاقاً مقصوداً، أضف إلى سجل الاختبار سبب اختيار القيم الجديدة حتى يميز القارئ تغيير السياسة من خطأ في حساب الحدود.

وأخيراً، افحص كيف يستقبل تطبيقك نتيجة القراءة قبل أن تعتمد عليها في مهمة تكتب ملفاً أو تطلب توليد صورة. يمكن استعمال مدخل صحيح ومدخل ناقص ومدخل صريح خارج المجال في اختبار يراقب بدء المهمة. القاعدة المتوقعة قد تسمح بقيمة افتراضية للحقل الناقص وفق سياسة معلنة، لكنها يجب أن تعرف أن الرقم غير المقبول حالة أخرى. تظل العينة المحلية شاهداً على لحظة التحويل والتمييز بين هذه الحالات. أما البدء الفعلي والعمل الذي يليه فيحتاجان دليلهما الخاص داخل المشروع.

أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعة آلية. اختُبرت الشيفرة الأصلية محلياً. الصورة الرئيسية توضح موضوع المقال.

التعليقات

كن أول من يعلّق على هذا المقال.

أضف تعليقاً

بريدك لن يُنشر. الحقول المطلوبة معلَّمة بنجمة.