شروع کار

به مستندات WebdriverIO خوش آمدید. It will help you to get started fast. If you run into problems, you can find help and answers on our Discord Support Server or you can hit me on Twitter.

:::نکته اینها اسناد آخرین نسخه (>= 8.x) WebdriverIO هستند. اگر هنوز از نسخه قدیمی‌تر استفاده می‌کنید، لطفاً از وب‌سایت اسناد قدیمی دیدن کنید! :::

Official YouTube Channel 🎥

You can find more videos around WebdriverIO on the official YouTube channel. Make sure you subscribe!

راه‌اندازی تنظیمات WebdriverIO

To add a full WebdriverIO setup to an existing or new project using the WebdriverIO Starter Toolkit, run:

تست را می توان با استفاده از دستور run و با اشاره به پیکربندی WebdriverIO که به تازگی ایجاد کرده اید اجرا کرد:

NPM

npm init wdio .

or if you want to create a new project:

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

Yarn

yarn create wdio .

or if you want to create a new project:

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

pnpm

pnpm create wdio .

or if you want to create a new project:

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

اگر دوست دارید فایل های تست خاصی را اجرا کنید، می توانید یک پارامتر --spec اضافه کنید:

Wizard مجموعه ای از سوالات را مطرح می کند که شما را برای راه‌اندازی راهنمایی می کند. شما می‌توانید از یک پارامتر --yes که برای انتخاب یک تنظیم پیش‌فرض که از Mocha با Chrome با استفاده از الگوی Page Object استفاده می‌شود، استفاده کنید.

NPM

npm init wdio . -- --yes

Yarn

yarn create wdio . --yes

pnpm

pnpm create wdio . --yes

Install CLI Manually

You can also add the CLI package to your project manually via:

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

# run configuration wizard
npx wdio config

اجرای تست

توجه: همه دستورهای WebdriverIO ناهمزمان هستند و باید با استفاده از async/await به درستی مدیریت شوند.

npx wdio run ./wdio.conf.js

اگر دوست دارید فایل های تست خاصی را اجرا کنید، می توانید یک پارامتر --spec اضافه کنید:

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

شما نیاز به نصب Node.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 دارید.

• حداقل v16.x یا بالاتر را نصب کنید زیرا این قدیمی ترین نسخه فعال LTS است
• فقط نسخه هایی که نسخه LTS هستند یا خواهند شد، رسما پشتیبانی می شوند

اگر Node در حال حاضر روی سیستم شما نصب نیست، پیشنهاد می کنیم از ابزاری مانند NVM یا Volta برای مدیریت چندین نسخه فعال Node.js استفاده کنید. NVM یک انتخاب محبوب است، در حالی که Volta نیز جایگزین خوبی است.