عرض مصدر Refactoring/replace exception with test

<noinclude>{{DISPLAYTITLE: استبدال الاستثناءات بالاختبارات (Replace Exception with Test)}}</noinclude> 
== المشكلة ==
إطلاق استثناء يمكن لاختبار بسيط أن يحل محله.

== الحل ==
يستعاض عن الاستثناء باختبار الحالة.

=== مثال ===

==== قبل إعادة التصميم ====
معالجة الاستثناء الحاصل عند وقوع الفهرس <code>periodNumber</code> خارج حدود مصفوفة القيم <code>values</code> وإعادة القيمة 0 آنذاك:

في لغة [[Java]]:<syntaxhighlight lang="java">
double getValueForPeriod(int periodNumber) {
  try {
    return values[periodNumber];
  } catch (ArrayIndexOutOfBoundsException e) {
    return 0;
  }
}
</syntaxhighlight>في لغة [[C#]]‎:<syntaxhighlight lang="c#">
double GetValueForPeriod(int periodNumber) 
{
  try 
  {
    return values[periodNumber];
  } 
  catch (IndexOutOfRangeException e) 
  {
    return 0;
  }
}
</syntaxhighlight>في لغة [[PHP]]:<syntaxhighlight lang="php">
function getValueForPeriod($periodNumber) {
  try {
    return $this->values[$periodNumber];
  } catch (ArrayIndexOutOfBoundsException $e) {
    return 0;
  }
}
</syntaxhighlight>في لغة [[Python]]:<syntaxhighlight lang="python">
def getValueForPeriod(periodNumber):
    try:
        return values[periodNumber]
    except IndexError:
        return 0
</syntaxhighlight>في لغة [[TypeScript]]:<syntaxhighlight lang="typescript">
getValueForPeriod(periodNumber: number): number {
  try {
    return values[periodNumber];
  } catch (ArrayIndexOutOfBoundsException e) {
    return 0;
  }
}
</syntaxhighlight>

==== بعد إعادة التصميم ====
استعمال شرط بسيط ينوب مكان التعبير <code>try/catch</code> الذي يعالج الاستثناء المحتمل وقوعه:

في لغة [[Java]]:<syntaxhighlight lang="java">
double getValueForPeriod(int periodNumber) {
  if (periodNumber >= values.length) {
    return 0;
  }
  return values[periodNumber];
}
</syntaxhighlight>في لغة [[C#]]‎:<syntaxhighlight lang="c#">
double GetValueForPeriod(int periodNumber) 
{
  if (periodNumber >= values.Length) 
  {
    return 0;
  }
  return values[periodNumber];
}
</syntaxhighlight>في لغة [[PHP]]:<syntaxhighlight lang="php">
function getValueForPeriod($periodNumber) {
  if ($periodNumber >= count($this->values)) {
    return 0;
  }
  return $this->values[$periodNumber];
}
</syntaxhighlight>في لغة [[Python]]:<syntaxhighlight lang="python">
def getValueForPeriod(self, periodNumber):
    if periodNumber >= len(self.values):
        return 0
    return self.values[periodNumber]
</syntaxhighlight>في لغة [[TypeScript]]:<syntaxhighlight lang="typescript">
getValueForPeriod(periodNumber: number): number {
  if (periodNumber >= values.length) {
    return 0;
  }
  return values[periodNumber];
}
</syntaxhighlight>

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

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

== فوائد تطبيق الحل ==
* في بعض الأحيان، يمكن أن يكون شرط بسيطة أكثر وضوحًا من شيفرة معالجة الاستثناء.

== آلية الحل ==
# إنشاء شرطية لحالة حدية ونقلها قبل كتلة <code>try/catch</code>.
# نقل الشيفرة من قسم <code>catch</code> داخل هذه الشرطية.
# في قسم <code>catch</code>، ضع الشيفرة لإطلاق استثناء غير مسمى عادي وشغِّل كل الاختبارات.
# وإذا لم تُطلق استثناءات خلال الاختبارات، تخلص من التعبير <code>try/catch</code>.

== انظر أيضًا ==
* [[Refactoring/replace error code with exception|استبدال شيفرات الأخطاء باستثناءات (Replace Error Code with Exception)]].

== مصادر ==
* [https://refactoring.guru/replace-exception-with-test صفحة توثيق استبدال الاستثناءات بالاختبارات في موقع refactoring.guru].
[[تصنيف:Refactoring]]
[[تصنيف:Refactoring Techniques]]
[[تصنيف:Refactoring Simplifying Method Calls]]