क्षमताएं

एक क्षमता एक रिमोट इंटरफेस के लिए परिभाषा है। यह WebdriverIO को समझने में मदद करता है कि आप अपने टेस्ट किस ब्राउज़र या मोबाइल वातावरण में चलाना चाहते हैं। स्थानीय स्तर पर टेस्ट विकसित करते समय क्षमताएं कम महत्वपूर्ण होती हैं क्योंकि आप इसे अधिकतर समय एक ही रिमोट इंटरफेस पर चलाते हैं, लेकिन CI/CD में एक बड़े सेट के एकीकरण परीक्षण चलाते समय अधिक महत्वपूर्ण हो जाती हैं।

जानकारी

क्षमता ऑब्जेक्ट का प्रारूप WebDriver विनिर्देशन द्वारा अच्छी तरह से परिभाषित किया गया है। WebdriverIO टेस्टरनर जल्दी से विफल हो जाएगा यदि उपयोगकर्ता परिभाषित क्षमताएं उस विनिर्देशन का पालन नहीं करती हैं।

कस्टम क्षमताएं

जबकि निश्चित परिभाषित क्षमताओं की संख्या बहुत कम है, हर कोई कस्टम क्षमताएं प्रदान और स्वीकार कर सकता है जो ऑटोमेशन ड्राइवर या रिमोट इंटरफेस के लिए विशिष्ट हैं:

ब्राउज़र विशिष्ट क्षमता एक्सटेंशन

• goog:chromeOptions: Chromedriver एक्सटेंशन, केवल Chrome में परीक्षण के लिए लागू
• moz:firefoxOptions: Geckodriver एक्सटेंशन, केवल Firefox में परीक्षण के लिए लागू
• ms:edgeOptions: EdgeOptions क्रोमियम Edge का परीक्षण करने के लिए EdgeDriver का उपयोग करते समय वातावरण निर्दिष्ट करने के लिए

क्लाउड वेंडर क्षमता एक्सटेंशन

• sauce:options: Sauce Labs
• bstack:options: BrowserStack
• tb:options: TestingBot
• और बहुत कुछ...

ऑटोमेशन इंजन क्षमता एक्सटेंशन

• 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

सावधानी

यदि ड्राइवर binary सेट है, तो WebdriverIO ड्राइवर डाउनलोड करने का प्रयास नहीं करेगा बल्कि इस पथ द्वारा प्रदान किए गए का उपयोग करेगा। सुनिश्चित करें कि ड्राइवर आपके द्वारा उपयोग किए जा रहे ब्राउज़र के साथ संगत है।

ब्राउज़र विशिष्ट ड्राइवर विकल्प

ड्राइवर को विकल्प प्रचारित करने के लिए आप निम्नलिखित कस्टम क्षमताओं का उपयोग कर सकते हैं:

• Chrome या Chromium: wdio:chromedriverOptions
• Firefox: wdio:geckodriverOptions
• Microsoft Egde: wdio:edgedriverOptions
• Safari: wdio:safaridriverOptions

wdio:chromedriverOptions

adbPort

वह पोर्ट जिस पर ADB ड्राइवर को चलना चाहिए।

उदाहरण: 9515

प्रकार: number

urlBase

कमांड के लिए बेस URL पथ प्रीफिक्स, जैसे wd/url।

उदाहरण: /

प्रकार: string

logPath

सर्वर लॉग को stderr के बजाय फ़ाइल में लिखें, लॉग स्तर को INFO तक बढ़ाता है

प्रकार: string

logLevel

लॉग स्तर सेट करें। संभावित विकल्प ALL, DEBUG, INFO, WARNING, SEVERE, OFF।

प्रकार: string

verbose

वर्बोज़ लॉग करें (--log-level=ALL के समतुल्य)

प्रकार: boolean

silent

कुछ भी लॉग न करें (--log-level=OFF के समतुल्य)

प्रकार: boolean

appendLog

लॉग फ़ाइल को पुनर्लेखन के बजाय अपेंड करें।

प्रकार: boolean

replayable

वर्बोज़ लॉग करें और लंबी स्ट्रिंग को ट्रंकेट न करें ताकि लॉग को रीप्ले किया जा सके (प्रयोगात्मक)।

प्रकार: boolean

readableTimestamp

लॉग में पठनीय टाइमस्टैम्प जोड़ें।

प्रकार: boolean

enableChromeLogs

ब्राउज़र से लॉग दिखाएं (अन्य लॉगिंग विकल्पों को ओवरराइड करता है)।

प्रकार: boolean

bidiMapperPath

कस्टम bidi मैपर पथ।

प्रकार: string

allowedIps

कॉमा-सेपरेटेड रिमोट IP एड्रेस की अनुमति सूची जिन्हें EdgeDriver से कनेक्ट करने की अनुमति है।

प्रकार: string[]
डिफ़ॉल्ट: ['']

allowedOrigins

कॉमा-सेपरेटेड अनुरोध उत्पत्ति की अनुमति सूची जिन्हें EdgeDriver से कनेक्ट करने की अनुमति है। किसी भी होस्ट उत्पत्ति की अनुमति देने के लिए * का उपयोग करना खतरनाक है!

प्रकार: string[]
डिफ़ॉल्ट: ['*']

spawnOpts

ड्राइवर प्रक्रिया में पारित किए जाने वाले विकल्प।

प्रकार: SpawnOptionsWithoutStdio | SpawnOptionsWithStdioTuple<StdioOption, StdioOption, StdioOption>
डिफ़ॉल्ट: undefined

wdio:geckodriverOptions

आधिकारिक ड्राइवर पैकेज में सभी Geckodriver विकल्प देखें।

wdio:edgedriverOptions

आधिकारिक ड्राइवर पैकेज में सभी Edgedriver विकल्प देखें।

wdio:safaridriverOptions

आधिकारिक ड्राइवर पैकेज में सभी Safaridriver विकल्प देखें।

विशिष्ट उपयोग मामलों के लिए विशेष क्षमताएँ

यह उदाहरणों की एक सूची है जो दिखाती है कि एक निश्चित उपयोग मामले को प्राप्त करने के लिए कौन सी क्षमताएँ लागू की जानी चाहिए।

ब्राउज़र को हेडलेस चलाएँ

हेडलेस ब्राउज़र चलाने का मतलब है विंडो या UI के बिना ब्राउज़र इंस्टेंस चलाना। इसका उपयोग अधिकतर CI/CD वातावरणों में किया जाता है जहां कोई डिस्प्ले नहीं होता है। हेडलेस मोड में ब्राउज़र चलाने के लिए, निम्नलिखित क्षमताएँ लागू करें:

Chrome

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

Firefox

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

Microsoft Edge

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

Safari

ऐसा लगता है कि Safari हेडलेस मोड में चलने का समर्थन नहीं करता है।

विभिन्न ब्राउज़र चैनलों को स्वचालित करें

यदि आप ऐसे ब्राउज़र संस्करण का परीक्षण करना चाहते हैं जो अभी तक स्थिर के रूप में जारी नहीं किया गया है, जैसे Chrome Canary, तो आप क्षमताओं को सेट करके और उस ब्राउज़र को इंगित करके ऐसा कर सकते हैं जिसे आप शुरू करना चाहते हैं, उदाहरण के लिए:

Chrome

Chrome पर परीक्षण करते समय, WebdriverIO परिभाषित browserVersion के आधार पर आपके लिए वांछित ब्राउज़र संस्करण और ड्राइवर को स्वचालित रूप से डाउनलोड करेगा, उदाहरण के लिए:

{
    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'
    }
}

Firefox

Firefox पर परीक्षण करते समय, WebdriverIO परिभाषित browserVersion के आधार पर आपके लिए वांछित ब्राउज़र संस्करण और ड्राइवर को स्वचालित रूप से डाउनलोड करेगा, उदाहरण के लिए:

{
    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'
    }
}

Microsoft Edge

Microsoft Edge पर परीक्षण करते समय, सुनिश्चित करें कि आपके पास वांछित ब्राउज़र संस्करण आपकी मशीन पर इंस्टॉल है। आप WebdriverIO को निष्पादित करने के लिए ब्राउज़र की ओर इशारा कर सकते हैं:

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

WebdriverIO परिभाषित browserVersion के आधार पर आपके लिए वांछित ड्राइवर संस्करण को स्वचालित रूप से डाउनलोड करेगा, उदाहरण के लिए:

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

इसके अतिरिक्त, यदि आप मैन्युअल रूप से डाउनलोड किए गए ड्राइवर का उपयोग करना चाहते हैं, तो आप ड्राइवर के लिए बाइनरी पथ प्रदान कर सकते हैं:

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

Safari

Safari पर परीक्षण करते समय, सुनिश्चित करें कि आपके पास Safari Technology Preview आपकी मशीन पर इंस्टॉल है। आप WebdriverIO को उस संस्करण की ओर इशारा कर सकते हैं:

{
    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': {
                // ...
            }
        }
    }
}