अनुरोध मॉक्स और स्पाई

WebdriverIO में निर्मित समर्थन है जो नेटवर्क प्रतिक्रियाओं को संशोधित करने की अनुमति देता है, जिससे आप अपने बैकएंड या मॉक सर्वर को सेट किए बिना अपने फ्रंटएंड एप्लिकेशन का परीक्षण कर सकते हैं। आप अपने टेस्ट में REST API अनुरोध जैसे वेब संसाधनों के लिए कस्टम प्रतिक्रियाएँ परिभाषित कर सकते हैं और उन्हें गतिशील रूप से संशोधित कर सकते हैं।

मॉक बनाना​

प्रतिक्रियाओं को संशोधित करने से पहले आपको पहले एक मॉक परिभाषित करना होगा। यह मॉक संसाधन url द्वारा वर्णित है और अनुरोध विधि या हेडर्स द्वारा फ़िल्टर किया जा सकता है। संसाधन minimatch द्वारा ग्लोब एक्सप्रेशन का समर्थन करता है:

// mock all resources ending with "/users/list"
const userListMock = await browser.mock('**/users/list')

// or you can specify the mock by filtering resources by headers or
// status code, only mock successful requests to json resources
const strictMock = await browser.mock('**', {
    // mock all json responses
    requestHeaders: { 'Content-Type': 'application/json' },
    // that were successful
    statusCode: 200
})

कस्टम प्रतिक्रियाएँ निर्दिष्ट करना​

एक बार जब आप मॉक परिभाषित कर लेते हैं, तो आप उसके लिए कस्टम प्रतिक्रियाएँ परिभाषित कर सकते हैं। ये कस्टम प्रतिक्रियाएँ या तो JSON प्रतिक्रिया के लिए एक ऑब्जेक्ट, कस्टम फिक्स्चर के साथ प्रतिक्रिया के लिए एक स्थानीय फ़ाइल या इंटरनेट से संसाधन के साथ प्रतिक्रिया बदलने के लिए एक वेब संसाधन हो सकती हैं।

API अनुरोधों को मॉक करना​

JSON प्रतिक्रिया की अपेक्षा वाले API अनुरोधों को मॉक करने के लिए, आपको बस मॉक ऑब्जेक्ट पर respond को उस अपेक्षित ऑब्जेक्ट के साथ कॉल करना होगा जिसे आप वापस लौटाना चाहते हैं, जैसे:

const mock = await browser.mock('https://todo-backend-express-knex.herokuapp.com/')

mock.respond([{
    title: 'Injected (non) completed Todo',
    order: null,
    completed: false
}, {
    title: 'Injected completed Todo',
    order: null,
    completed: true
}], {
    headers: {
        'Access-Control-Allow-Origin': '*'
    },
    fetchResponse: false
})

await browser.url('https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/')

await $('#todo-list li').waitForExist()
console.log(await $$('#todo-list li').map(el => el.getText()))
// outputs: "[ 'Injected (non) completed Todo', 'Injected completed Todo' ]"

आप कुछ मॉक प्रतिक्रिया पैरामीटर्स के रूप में निम्नलिखित तरीके से प्रतिक्रिया हेडर्स और स्टेटस कोड को भी संशोधित कर सकते हैं:

mock.respond({ ... }, {
    // respond with status code 404
    statusCode: 404,
    // merge response headers with following headers
    headers: { 'x-custom-header': 'foobar' }
})

यदि आप चाहते हैं कि मॉक बैकएंड को बिल्कुल भी कॉल न करे, तो आप fetchResponse फ्लैग के लिए false पास कर सकते हैं।

mock.respond({ ... }, {
    // do not call the actual backend
    fetchResponse: false
})

यह अनुशंसित है कि आप कस्टम प्रतिक्रियाओं को फिक्स्चर फ़ाइलों में स्टोर करें ताकि आप उन्हें अपने टेस्ट में निम्नानुसार आसानी से आयात कर सकें:

// requires Node.js v16.14.0 or higher to support JSON import assertions
import responseFixture from './__fixtures__/apiResponse.json' assert { type: 'json' }
mock.respond(responseFixture)

टेक्स्ट संसाधनों को मॉक करना​

यदि आप JavaScript, CSS फाइलें या अन्य टेक्स्ट आधारित संसाधनों जैसे टेक्स्ट संसाधनों को संशोधित करना चाहते हैं, तो आप बस एक फ़ाइल पथ पास कर सकते हैं और WebdriverIO मूल संसाधन को उससे बदल देगा, जैसे:

const scriptMock = await browser.mock('**/script.min.js')
scriptMock.respond('./tests/fixtures/script.js')

// or respond with your custom JS
scriptMock.respond('alert("I am a mocked resource")')

वेब संसाधनों को रीडायरेक्ट करना​

आप किसी वेब संसाधन को किसी अन्य वेब संसाधन से भी बदल सकते हैं अगर आपका वांछित प्रतिक्रिया पहले से ही वेब पर होस्ट की गई है। यह व्यक्तिगत पेज संसाधनों के साथ-साथ वेबपेज के साथ भी काम करता है, जैसे:

const pageMock = await browser.mock('https://google.com/')
await pageMock.respond('https://webdriver.io')
await browser.url('https://google.com')
console.log(await browser.getTitle()) // returns "WebdriverIO · Next-gen browser and mobile automation test framework for Node.js"

डायनामिक प्रतिक्रियाएँ​

यदि आपकी मॉक प्रतिक्रिया मूल संसाधन प्रतिक्रिया पर निर्भर करती है, तो आप एक फंक्शन पास करके गतिशील रूप से संसाधन को संशोधित कर सकते हैं जो मूल प्रतिक्रिया को पैरामीटर के रूप में प्राप्त करता है और रिटर्न वैल्यू के आधार पर मॉक सेट करता है, जैसे:

const mock = await browser.mock('https://todo-backend-express-knex.herokuapp.com/', {
    method: 'get'
})

mock.respond((req) => {
    // replace todo content with their list number
    return req.body.map((item, i) => ({ ...item, title: i }))
})

await browser.url('https://todobackend.com/client/index.html?https://todo-backend-express-knex.herokuapp.com/')

await $('#todo-list li').waitForExist()
console.log(await $$('#todo-list li label').map((el) => el.getText()))
// returns
// [
//   '0',  '1',  '2',  '19', '20',
//   '21', '3',  '4',  '5',  '6',
//   '7',  '8',  '9',  '10', '11',
//   '12', '13', '14', '15', '16',
//   '17', '18', '22'
// ]

मॉक्स को बाधित करना​

कस्टम प्रतिक्रिया लौटाने के बजाय, आप बस निम्नलिखित HTTP त्रुटियों में से एक के साथ अनुरोध को बाधित कर सकते हैं:

• Failed
• Aborted
• TimedOut
• AccessDenied
• ConnectionClosed
• ConnectionReset
• ConnectionRefused
• ConnectionAborted
• ConnectionFailed
• NameNotResolved
• InternetDisconnected
• AddressUnreachable
• BlockedByClient
• BlockedByResponse

यह बहुत उपयोगी है यदि आप अपने पेज से तृतीय पक्ष स्क्रिप्ट को ब्लॉक करना चाहते हैं जिनका आपके फंक्शनल टेस्ट पर नकारात्मक प्रभाव पड़ता है। आप बस abort या abortOnce कॉल करके मॉक को बाधित कर सकते हैं, जैसे:

const mock = await browser.mock('https://www.google-analytics.com/**')
mock.abort('Failed')

स्पाई​

प्रत्येक मॉक स्वचालित रूप से एक स्पाई है जो उस संसाधन के लिए ब्राउज़र द्वारा किए गए अनुरोधों की संख्या की गणना करता है। यदि आप मॉक पर कोई कस्टम प्रतिक्रिया या abort कारण लागू नहीं करते हैं, तो यह आपके द्वारा सामान्य रूप से प्राप्त डिफ़ॉल्ट प्रतिक्रिया के साथ जारी रहता है। इससे आप यह जांच सकते हैं कि ब्राउज़र ने कितनी बार अनुरोध किया, जैसे कि एक निश्चित API एंडपॉइंट पर।

const mock = await browser.mock('**/user', { method: 'post' })
console.log(mock.calls.length) // returns 0

// register user
await $('#username').setValue('randomUser')
await $('password').setValue('password123')
await $('password_repeat').setValue('password123')
await $('button[type="submit"]').click()

// check if API request was made
expect(mock.calls.length).toBe(1)

// assert response
expect(mock.calls[0].body).toEqual({ success: true })

यदि आपको मिलान करने वाले अनुरोध के जवाब देने तक इंतजार करने की आवश्यकता है, तो mock.waitForResponse(options) का उपयोग करें। API संदर्भ देखें: waitForResponse।