القدرات

القدرة هي تعريف لواجهة التحكم عن بعد. وهي تساعد WebdriverIO على فهم البيئة المتصفحية أو المحمولة التي ترغب في تشغيل اختباراتك عليها. تعتبر القدرات أقل أهمية عند تطوير الاختبارات محليًا لأنك تقوم بتشغيلها على واجهة تحكم واحدة في معظم الأوقات، لكنها تصبح أكثر أهمية عند تشغيل مجموعة كبيرة من اختبارات التكامل في CI/CD.

القدرات المخصصة​

بينما يكون عدد القدرات المحددة الثابتة منخفضًا جدًا، يمكن للجميع توفير وقبول قدرات مخصصة خاصة بسائق الأتمتة أو واجهة التحكم عن بعد:

امتدادات القدرات الخاصة بالمتصفح​

• goog:chromeOptions: امتدادات Chromedriver، قابلة للتطبيق فقط للاختبار في Chrome
• moz:firefoxOptions: امتدادات Geckodriver، قابلة للتطبيق فقط للاختبار في Firefox
• ms:edgeOptions: EdgeOptions لتحديد البيئة عند استخدام EdgeDriver لاختبار Chromium Edge

امتدادات قدرات مزودي الخدمات السحابية​

• sauce:options: Sauce Labs
• bstack:options: BrowserStack
• tb:options: TestingBot
• LT:Options: LambdaTest
• والعديد غيرها...

امتدادات قدرات محرك الأتمتة​

• appium:xxx: Appium
• selenoid:xxx: Selenoid
• والعديد غيرها...

قدرات WebdriverIO لإدارة خيارات سائق المتصفح​

يدير WebdriverIO تثبيت وتشغيل سائق المتصفح نيابة عنك. يستخدم WebdriverIO قدرة مخصصة تسمح لك بتمرير معلمات إلى السائق.

wdio:chromedriverOptions​

خيارات محددة تمرر إلى Chromedriver عند بدء تشغيله.

wdio:geckodriverOptions​

خيارات محددة تمرر إلى Geckodriver عند بدء تشغيله.

wdio:edgedriverOptions​

خيارات محددة تمرر إلى Edgedriver عند بدء تشغيله.

wdio:safaridriverOptions​

خيارات محددة تمرر إلى Safari عند بدء تشغيله.

wdio:maxInstances​

الحد الأقصى لعدد العمليات المتوازية الإجمالية للمتصفح/القدرة المحددة. يأخذ الأسبقية على maxInstances و maxInstancesPerCapability.

النوع: number

wdio:specs​

تحديد المواصفات لتنفيذ الاختبار لذلك المتصفح/القدرة. مثل خيار التكوين العادي specs، ولكن خاص بالمتصفح/القدرة. يأخذ الأسبقية على specs.

النوع: (String | String[])[]

wdio:exclude​

استبعاد المواصفات من تنفيذ الاختبار لذلك المتصفح/القدرة. مثل خيار التكوين العادي exclude، ولكن خاص بالمتصفح/القدرة. يتم الاستبعاد بعد تطبيق خيار التكوين العام exclude.

النوع: String[]

wdio:enforceWebDriverClassic​

افتراضيًا، يحاول WebdriverIO إنشاء جلسة WebDriver Bidi. إذا كنت لا تفضل ذلك، يمكنك تعيين هذه العلامة لتعطيل هذا السلوك.

النوع: boolean

خيارات السائق الشائعة​

بينما تقدم جميع برامج التشغيل معلمات مختلفة للتكوين، هناك بعض الخيارات المشتركة التي يفهمها WebdriverIO ويستخدمها لإعداد برنامج التشغيل أو المتصفح الخاص بك:

cacheDir​

المسار إلى جذر دليل التخزين المؤقت. يستخدم هذا الدليل لتخزين جميع برامج التشغيل التي يتم تنزيلها عند محاولة بدء جلسة.

النوع: string
الافتراضي: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

binary​

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

يمكنك توفير هذا المسار عبر متغيرات البيئة CHROMEDRIVER_PATH أو GECKODRIVER_PATH أو EDGEDRIVER_PATH.

النوع: string

خيارات برنامج التشغيل الخاصة بالمتصفح​

لنشر الخيارات إلى برنامج التشغيل، يمكنك استخدام القدرات المخصصة التالية:

• Chrome أو Chromium: wdio:chromedriverOptions
• Firefox: wdio:geckodriverOptions
• Microsoft Edge: wdio:edgedriverOptions
• Safari: wdio:safaridriverOptions

القدرات الخاصة لحالات الاستخدام المحددة​

هذه قائمة بالأمثلة التي توضح القدرات التي يجب تطبيقها لتحقيق حالة استخدام معينة.

تشغيل المتصفح بدون واجهة رسومية​

تشغيل متصفح بدون واجهة رسومية يعني تشغيل نسخة من المتصفح بدون نافذة أو واجهة مستخدم. يتم استخدام هذا غالبًا في بيئات CI/CD حيث لا يتم استخدام شاشة عرض. لتشغيل متصفح في وضع بدون واجهة رسومية، قم بتطبيق القدرات التالية:

{
    browserName: 'chrome',   // or 'chromium'
    'goog:chromeOptions': {
        args: ['headless', 'disable-gpu']
    }
}

    browserName: 'firefox',
    'moz:firefoxOptions': {
        args: ['-headless']
    }

    browserName: 'msedge',
    'ms:edgeOptions': {
        args: ['--headless']
    }

أتمتة قنوات المتصفح المختلفة​

إذا كنت ترغب في اختبار إصدار متصفح لم يتم إصداره بعد كإصدار مستقر، مثل Chrome Canary، يمكنك القيام بذلك عن طريق تعيين القدرات والإشارة إلى المتصفح الذي ترغب في بدء تشغيله، على سبيل المثال:

{
    browserName: 'chrome', // or 'chromium'
    browserVersion: '116' // or '116.0.5845.96', 'stable', 'dev', 'canary', 'beta' or 'latest' (same as 'canary')
}

{
    browserName: 'chrome',  // or 'chromium'
    'goog:chromeOptions': {
        binary: '/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary'
    }
}

{
    browserName: 'chrome', // or 'chromium'
    'wdio:chromedriverOptions': {
        binary: '/path/to/chromdriver'
    }
}

{
    browserName: 'firefox',
    browserVersion: '119.0a1' // or 'latest'
}

{
    browserName: 'firefox',
    'moz:firefoxOptions': {
        binary: '/Applications/Firefox\ Nightly.app/Contents/MacOS/firefox'
    }
}

{
    browserName: 'firefox',
    'wdio:geckodriverOptions': {
        binary: '/path/to/geckodriver'
    }
}

{
    browserName: 'msedge',
    'ms:edgeOptions': {
        binary: '/Applications/Microsoft\ Edge\ Canary.app/Contents/MacOS/Microsoft\ Edge\ Canary'
    }
}

{
    browserName: 'msedge',
    browserVersion: '109' // or '109.0.1467.0', 'stable', 'dev', 'canary', 'beta'
}

{
    browserName: 'msedge',
    'wdio:edgedriverOptions': {
        binary: '/path/to/msedgedriver'
    }
}

{
    browserName: 'safari technology preview'
}

توسيع القدرات المخصصة​

إذا كنت ترغب في تحديد مجموعتك الخاصة من القدرات من أجل، على سبيل المثال، تخزين بيانات عشوائية لاستخدامها داخل الاختبارات لتلك القدرة المحددة، يمكنك القيام بذلك عن طريق تعيين:

export const config = {
    // ...
    capabilities: [{
        browserName: 'chrome',
        'custom:caps': {
            // custom configurations
        }
    }]
}

يُنصح باتباع بروتوكول W3C عندما يتعلق الأمر بتسمية القدرات، والذي يتطلب حرف : (نقطتين)، مشيرًا إلى مساحة اسم خاصة بالتنفيذ. ضمن اختباراتك يمكنك الوصول إلى القدرة المخصصة الخاصة بك من خلال:

browser.capabilities['custom:caps']

لضمان سلامة النوع، يمكنك توسيع واجهة قدرة WebdriverIO عبر:

declare global {
    namespace WebdriverIO {
        interface Capabilities {
            'custom:caps': {
                // ...
            }
        }
    }
}