क्षमताएँ

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

जानकारी

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

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

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

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

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

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

• 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 कॉन्फिगरेशन विकल्प के समान, लेकिन ब्राउज़र/क्षमता के लिए विशिष्ट। specs पर प्राथमिकता लेता है।

प्रकार: (String | String[])[]

wdio:exclude

उस ब्राउज़र/क्षमता के लिए टेस्ट एक्ज़ीक्यूशन से specs को बाहर रखें। नियमित 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

कस्टम बिडी मैपर पथ।

प्रकार: 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',   // या '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', // या 'chromium'
    browserVersion: '116' // या '116.0.5845.96', 'stable', 'dev', 'canary', 'beta' या 'latest' ('canary' के समान)
}

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

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

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

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

Firefox

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

{
    browserName: 'firefox',
    browserVersion: '119.0a1' // या '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' // या '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': {
            // कस्टम कॉन्फिगरेशन
        }
    }]
}

क्षमता नामकरण के मामले में W3C प्रोटोकॉल का पालन करने की सलाह दी जाती है, जिसके लिए एक : (कोलन) अक्षर की आवश्यकता होती है, जो एक कार्यान्वयन विशिष्ट नेमस्पेस को इंगित करता है। अपने परीक्षणों के भीतर आप अपनी कस्टम क्षमता तक पहुंच सकते हैं, उदाहरण के लिए:

browser.capabilities['custom:caps']

टाइप सुरक्षा सुनिश्चित करने के लिए आप WebdriverIO क्षमता इंटरफेस का विस्तार कर सकते हैं:

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