البدء

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

معلومات

هذه هي الوثائق للإصدار الأحدث (>=9.x) من WebdriverIO. إذا كنت لا تزال تستخدم إصدارًا أقدم، يرجى زيارة مواقع التوثيق القديمة!

القناة الرسمية على YouTube 🎥

يمكنك العثور على المزيد من مقاطع الفيديو حول WebdriverIO على القناة الرسمية على YouTube. تأكد من الاشتراك!

بدء إعداد WebdriverIO

لإضافة إعداد كامل لـ WebdriverIO إلى مشروع موجود أو جديد باستخدام مجموعة أدوات بدء WebdriverIO، قم بتشغيل:

إذا كنت في الدليل الجذر لمشروع موجود، قم بتشغيل:

NPM

npm init wdio@latest .

أو إذا كنت ترغب في إنشاء مشروع جديد:

npm init wdio@latest ./path/to/new/project

Yarn

yarn create wdio .

أو إذا كنت ترغب في إنشاء مشروع جديد:

yarn create wdio ./path/to/new/project

pnpm

pnpm create wdio@latest .

أو إذا كنت ترغب في إنشاء مشروع جديد:

pnpm create wdio@latest ./path/to/new/project

bun

bun create wdio@latest .

أو إذا كنت ترغب في إنشاء مشروع جديد:

bun create wdio@latest ./path/to/new/project

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

سيطرح المعالج مجموعة من الأسئلة التي ترشدك خلال الإعداد. يمكنك تمرير المعلمة --yes لاختيار إعداد افتراضي والذي سيستخدم Mocha مع Chrome باستخدام نمط Page Object.

NPM

npm init wdio@latest . -- --yes

Yarn

yarn create wdio . --yes

pnpm

pnpm create wdio@latest . --yes

bun

bun create wdio@latest . --yes

تثبيت CLI يدويًا

يمكنك أيضًا إضافة حزمة CLI إلى مشروعك يدويًا عبر:

npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`

# run configuration wizard
npx wdio config

تشغيل الاختبار

يمكنك بدء مجموعة الاختبار الخاصة بك باستخدام الأمر run والإشارة إلى تكوين WebdriverIO الذي أنشأته للتو:

npx wdio run ./wdio.conf.js

إذا كنت ترغب في تشغيل ملفات اختبار محددة، يمكنك إضافة معلمة --spec:

npx wdio run ./wdio.conf.js --spec example.e2e.js

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

npx wdio run ./wdio.conf.js --suite exampleSuiteName

التشغيل في سكريبت

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

getting-started/run-in-script.js

loading...

View on GitHub

ملاحظة: جميع أوامر WebdriverIO غير متزامنة وتحتاج إلى معالجة بشكل صحيح باستخدام async/await.

تسجيل الاختبارات

يوفر WebdriverIO أدوات لمساعدتك على البدء من خلال تسجيل إجراءات الاختبار الخاصة بك على الشاشة وإنشاء نصوص اختبار WebdriverIO تلقائيًا. راجع تسجيل الاختبارات باستخدام مسجل Chrome DevTools للحصول على مزيد من المعلومات.

متطلبات النظام

ستحتاج إلى تثبيت Node.js.

• قم بتثبيت الإصدار v18.20.0 على الأقل أو أعلى حيث أن هذا هو أقدم إصدار LTS نشط
• فقط الإصدارات التي هي أو ستصبح إصدار LTS مدعومة رسميًا

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