شروع به کار
به مستندات WebdriverIO خوش آمدید. این مستندات به شما کمک می‌کند تا سریع شروع کنید. اگر به مشکلی برخوردید، می‌توانید کمک و پاسخ‌ها را در سرور پشتیبانی Discord ما پیدا کنید یا می‌توانید با من در توییتر در تماس باشید.
این‌ها مستندات آخرین نسخه (>=9.x) WebdriverIO هستند. اگر هنوز از نسخه قدیمی‌تری استفاده می‌کنید، لطفاً از وب‌سایت‌های مستندات قدیمی بازدید کنید!
شما می‌توانید ویدیوهای بیشتری درباره WebdriverIO در کانال رسمی یوتیوب پیدا کنید. حتماً مشترک شوید!
راه‌اندازی یک پروژه WebdriverIO
برای اضافه کردن یک راه‌اندازی کامل WebdriverIO به یک پروژه موجود یا جدید با استفاده از WebdriverIO Starter Toolkit، اجرا کنید:
اگر در دایرکتوری ریشه یک پروژه موجود هستید، اجرا کنید:
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
یا اگر می‌خواهید یک پروژه جدید ایجاد کنید:
npm init wdio@latest ./path/to/new/project
yarn create wdio .
یا اگر می‌خواهید یک پروژه جدید ایجاد کنید:
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
یا اگر می‌خواهید یک پروژه جدید ایجاد کنید:
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
یا اگر می‌خواهید یک پروژه جدید ایجاد کنید:
bun create wdio@latest ./path/to/new/project
این دستور ابزار خط فرمان WebdriverIO را دانلود می‌کند و یک ویزارد پیکربندی را اجرا می‌کند که به شما در پیکربندی مجموعه آزمایش خود کمک می‌کند.
ویزارد مجموعه‌ای از سؤالات را مطرح می‌کند که شما را در راه‌اندازی راهنمایی می‌کند. می‌توانید پارامتر --yes را ارسال کنید تا یک راه‌اندازی پیش‌فرض را انتخاب کنید که از Mocha با Chrome با استفاده از الگوی Page Object استفاده می‌کند.
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest . -- --yes
yarn create wdio . --yes
pnpm create wdio@latest . --yes
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 را مستقیماً نصب کنید و از آن به عنوان یک بسته استفاده کنید، مثلاً برای تولید یک اسکرین‌شات از یک وب‌سایت:
loading...
توجه: تمامی دستورات WebdriverIO غیرهمزمان (asynchronous) هستند و باید با استفاده از async/await به درستی مدیریت شوند.
ضبط آزمایش‌ها
WebdriverIO ابزارهایی را برای کمک به شما در شروع با ضبط اقدامات آزمایشی شما بر روی صفحه نمایش و تولید خودکار اسکریپت‌های آزمایشی WebdriverIO ارائه می‌دهد. برای اطلاعات بیشتر به ضبط آزمایش‌ها با Chrome DevTools Recorder مراجعه کنید.
نیازمندی‌های سیستم
شما به Node.js نصب شده نیاز خواهید داشت.
- حداقل نسخه v18.20.0 یا بالاتر را نصب کنید زیرا این قدیمی‌ترین نسخه فعال LTS است
- فقط نسخه‌هایی که LTS هستند یا به LTS تبدیل خواهند شد، به طور رسمی پشتیبانی می‌شوند
اگر Node در حال حاضر روی سیستم شما نصب نیست، ما پیشنهاد می‌کنیم از ابزاری مانند NVM یا Volta برای کمک به مدیریت چندین نسخه فعال Node.js استفاده کنید. NVM یک انتخاب محبوب است، در حالی که Volta نیز یک جایگزین خوب است.
