البدء

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

معلومات

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

القناة الرسمية على يوتيوب 🎥

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

بدء إعداد 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 إلى مشروعك يدويًا عبر:

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 Recorder للحصول على مزيد من المعلومات.

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

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

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

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