Jest: التضارب في المستندات والأمثلة

قام PR # 3172 بتحديث المستندات لتضمين الكلمات الرئيسية الجديدة .resolves و .rejects لتشغيل التأكيدات على الوعود.

لقد لاحظت أن هذه العلاقات العامة قدمت بعض التناقضات في قسم معالجة الأخطاء المحدث في https://github.com/facebook/jest/blob/master/docs/TutorialAsync.md. توجد لقطة شاشة لهذا القسم أدناه:

1. التعليقات في الجزء العلوي من الاختبار لا تزال تشير إلى try-catch ، وهذا لا يتوافق مع الكود الموجود في مقتطفات التعليمات البرمجية.
2. يعرض PR فقط مثالاً بـ .rejects والذي سيكون متاحًا فقط في Jest 20+. يجب ذكر ذلك في المستندات لتجنب الالتباس.
3. لن يتمكن الأشخاص الذين يستخدمون إصدارات قديمة من Jest من استخدام هذه الوثائق. أعتقد أنه يجب علينا إعادة شرح استخدام try-catch للقبض على رفض الوعد (الذي تمت إزالته في PR # 3172) للأشخاص الذين يستخدمون Jest 19 وما بعده. يمكن أن يتواجد هذا بجانب المستندات الحالية باستخدام .rejects .
4. المثال المضمن في الرابط examples/async روابط لأمثلة اختبار مثل هذه . لا تزال هذه الأمثلة تستخدم آلية try-catch ، وهذا غير متوافق مع أمثلة التعليمات البرمجية الموجودة حاليًا في المستندات. هذه أسباب أخرى تجعلنا نعيد إضافة شرح استخدام try-catch إلى هذا القسم من المستندات.