react hooks testing library تنزيل - react hooks testing library تنزيل كود المصدر

react hooks testing library

شفرة المصدر الأخرى

v8.0.1

تنزيل

مكتبة اختبار الخطافات التفاعلية

أدوات اختبار خطافات React البسيطة والكاملة التي تشجع ممارسات الاختبار الجيدة.

قراءة المستندات

ملاحظة حول دعم React 18

إذا كنت تستخدم الإصدار الحالي من react-testing-library ، فاستبدل

 import { renderHook } from '@testing-library/react-hooks'

مع

 import { renderHook } from '@testing-library/react'

بمجرد الاستبدال، يمكن إلغاء تثبيت @testing-library/react-hooks .

تفاصيل

كجزء من التغييرات في React 18، فقد تقرر بدلاً من ذلك تضمين واجهة برمجة تطبيقات renderHook التي توفرها هذه المكتبة كإضافات رسمية إلى كل من react-testing-library (PR) react-native-testing-library (PR) مع والقصد من ذلك هو توفير تنفيذ أكثر تماسكًا واتساقًا لمستخدمينا.

يرجى التحلي بالصبر بينما ننتهي من هذه التغييرات في مكتبات الاختبار المعنية. في هذه الأثناء، يمكنك تثبيت @testing-library/react@^13.1

جدول المحتويات

المشكلة
الحل
متى تستخدم هذه المكتبة
متى لا تستخدم هذه المكتبة
مثال
- useCounter.js
- useCounter.test.js
تثبيت
- تبعيات الأقران
واجهة برمجة التطبيقات
المساهمين
مشاكل
- ؟ البق
- طلبات الميزة
- ❓ الأسئلة
رخصة

المشكلة

أنت تكتب رابطًا مخصصًا رائعًا وتريد اختباره، ولكن بمجرد استدعائه، ترى الخطأ التالي:

الانتهاك الثابت: لا يمكن استدعاء الخطافات إلا داخل نص مكون الوظيفة.

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

الحل

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

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

متى تستخدم هذه المكتبة

أنت تكتب مكتبة تحتوي على خطاف مخصص واحد أو أكثر غير مرتبط مباشرة بمكون ما
لديك ربط معقد يصعب اختباره من خلال تفاعلات المكونات

متى لا تستخدم هذه المكتبة

يتم تعريف الخطاف الخاص بك جنبًا إلى جنب مع المكون ويتم استخدامه هناك فقط
من السهل اختبار الخطاف الخاص بك بمجرد اختبار المكونات التي تستخدمه

مثال

`useCounter.js`

 import { useState , useCallback } from 'react'

function useCounter ( ) {
  const [ count , setCount ] = useState ( 0 )

  const increment = useCallback ( ( ) => setCount ( ( x ) => x + 1 ) , [ ] )

  return { count , increment }
}

export default useCounter

`useCounter.test.js`

 import { renderHook , act } from '@testing-library/react-hooks'
import useCounter from './useCounter'

test ( 'should increment counter' , ( ) => {
  const { result } = renderHook ( ( ) => useCounter ( ) )

  act ( ( ) => {
    result . current . increment ( )
  } )

  expect ( result . current . count ) . toBe ( 1 )
} )

يمكن العثور على استخدام أكثر تقدمًا في الوثائق.

تثبيت

npm install --save-dev @testing-library/react-hooks

تبعيات الأقران

react-hooks-testing-library لا تأتي مرفقة بإصدار react للسماح لك بتثبيت الإصدار المحدد الذي تريد اختباره. كما أنه لا يأتي مثبتًا مع عارض محدد، فنحن ندعم حاليًا react-test-renderer و react-dom . ما عليك سوى تثبيت أحدهما، ومع ذلك، إذا كان كلاهما مثبتًا لديك، فسنستخدم react-test-renderer كإعداد افتراضي. لمزيد من المعلومات، راجع مستندات التثبيت. بشكل عام، يجب أن تحتوي الإصدارات المثبتة من react والعارض المحدد على إصدارات متطابقة:

npm install react@^16.9.0
npm install --save-dev react-test-renderer@^16.9.0

ملاحظة: الحد الأدنى للإصدار المدعوم من react و react-test-renderer و react-dom هو ^16.9.0 .

واجهة برمجة التطبيقات

راجع مرجع API.

المساهمين

الشكر موصول لهؤلاء الأشخاص الرائعين (مفتاح الرموز التعبيرية):

_{مايكل بيبر} ؟ ؟ ؟ ️	_{ساحة أوتوفو}	_{باتريك ب. هينلي} ؟ ؟	_{ماتيوس ماركيز}	_{دروف باتيل} ؟ ؟	_{ناثانيال تاكر} ؟ ؟	_{سيرجي جريشينكو} ؟
_{جوزيب إم سوبريبير}	_{مارسيل تينر}	_{دانيال ك.} ؟	_{فينس مالون}	_{سيباستيان ويبر}	_{كريستيان جيل}	_{جافا سكريبت جو} ✅ ️
_{سارة ديان} ؟	_{رومان جوسيف}	_{آدم سيكل}	_{كيا ساساكي} ️	_{هو تشن}	_جوش ؟ ؟ ️	_{نعمان هيرشفيلد}
_{قاعة بريدون}	_{جاكوب إم جي إيفانز} ️	_{النمر ابرودي} ️	_{عمرو محمد} ️	_{جوهانا جوهياينن}	_{ينس مينديرتسما} ️	_{ماركو موريتي} ؟
_{مارتن ف.}	_اروزاك	_{نيك مكوردي} ؟	_آريا	_خدر86	_{اليكس يونج} ؟	_{بن لامبرت}
_{ديفيد تشو ليرات}	_{إيفان هارمون}	_{جيسون براون}	_{كاهوي تنغ}	_{ليونيد شغابوتدينوف}	_{ليفي جزار}	_{ميشيل سيتيباني}
_سام	_{تاناي براتاب}	_{توم ريس هيردمان}	_iqbal125	_{cliffzhaobupt} ؟	_{جون كوبس}	_{جوناثان بيبر} ؟
_{شون بينز}	_{ميخائيل فاسين}	_{ألكسندر جربيتش}	_{جوناثان هولمز}	_{مايكل دي بوي} ؟	_{انطون زينوفييف} ؟	_{ماريانا-إكسيلاتي} ؟
_{ماتان بورينكراوت} ؟	_{com.andyrooger}	_{بريان وين} ؟ ؟	_{روبرت سنو} ️	_{كريس تشين} ️	_ماسيوس	_{لايشوكسين}