மாக் (Mock) அகாரம்

மாக் (mock) அகாரம் என்பது நெட்வொர்க் மாக்கை பிரதிநிதித்துவப்படுத்தும் ஒரு பொருள் மற்றும் கொடுக்கப்பட்ட url மற்றும் filterOptions உடன் பொருந்திய கோரிக்கைகள் பற்றிய தகவல்களைக் கொண்டுள்ளது. இதை mock கட்டளையைப் பயன்படுத்தி பெறலாம்.

தகவல்

mock கட்டளையைப் பயன்படுத்த Chrome DevTools protocol க்கான ஆதரவு தேவை என்பதை கவனிக்கவும். நீங்கள் Chromium அடிப்படையிலான உலாவியில் சோதனைகளை உள்ளூரில் இயக்கினால் அல்லது Selenium Grid v4 அல்லது அதற்கு மேற்பட்டதைப் பயன்படுத்தினால் அந்த ஆதரவு கிடைக்கிறது. இந்த கட்டளை கிளவுடில் தானியங்கி சோதனைகளை இயக்கும்போது பயன்படுத்த முடியாது. Automation Protocols பிரிவில் மேலும் அறியவும்.

WebdriverIO இல் கோரிக்கைகள் மற்றும் பதில்களை மாக் செய்வது பற்றி எங்கள் Mocks and Spies வழிகாட்டியில் மேலும் படிக்கலாம்.

பண்புகள்

ஒரு மாக் அகாரம் பின்வரும் பண்புகளைக் கொண்டுள்ளது:

பெயர்	வகை	விவரங்கள்
url	String	மாக் கட்டளைக்கு அனுப்பப்பட்ட url
filterOptions	Object	மாக் கட்டளைக்கு அனுப்பப்பட்ட வள வடிகட்டி விருப்பங்கள்
browser	Object	மாக் அகாரத்தைப் பெற பயன்படுத்தப்படும் உலாவி அகாரம்.
calls	Object[]	பொருந்தும் உலாவி கோரிக்கைகள் பற்றிய தகவல், url, method, headers, initialPriority, referrerPolic, statusCode, responseHeaders மற்றும் body போன்ற பண்புகளைக் கொண்டுள்ளது

முறைகள்

மாக் பொருட்கள் mock பிரிவில் பட்டியலிடப்பட்டுள்ள பல்வேறு கட்டளைகளை வழங்குகின்றன, அவை பயனர்களுக்கு கோரிக்கை அல்லது பதிலின் நடத்தையை மாற்ற அனுமதிக்கின்றன.

• abort
• abortOnce
• clear
• request
• requestOnce
• respond
• respondOnce
• restore

நிகழ்வுகள்

மாக் அகாரம் ஒரு EventEmitter ஆகும், மேலும் உங்கள் பயன்பாட்டு வழக்குகளுக்காக சில நிகழ்வுகள் வெளியிடப்படுகின்றன.

இங்கே நிகழ்வுகளின் பட்டியல் உள்ளது.

request

இந்த நிகழ்வு மாக் வடிவங்களுடன் பொருந்தும் நெட்வொர்க் கோரிக்கையைத் தொடங்கும்போது வெளியிடப்படுகிறது. கோரிக்கை நிகழ்வு கால்பேக்கில் அனுப்பப்படுகிறது.

கோரிக்கை இடைமுகம்:

interface RequestEvent {
    requestId: number
    request: Matches
    responseStatusCode: number
    responseHeaders: Record<string, string>
}

overwrite

இந்த நிகழ்வு நெட்வொர்க் பதில் respond அல்லது respondOnce மூலம் மேலெழுதப்படும்போது வெளியிடப்படுகிறது. பதில் நிகழ்வு கால்பேக்கில் அனுப்பப்படுகிறது.

பதில் இடைமுகம்:

interface OverwriteEvent {
    requestId: number
    responseCode: number
    responseHeaders: Record<string, string>
    body?: string | Record<string, any>
}

fail

இந்த நிகழ்வு நெட்வொர்க் கோரிக்கை abort அல்லது abortOnce மூலம் நிறுத்தப்படும்போது வெளியிடப்படுகிறது. தோல்வி நிகழ்வு கால்பேக்கில் அனுப்பப்படுகிறது.

தோல்வி இடைமுகம்:

interface FailEvent {
    requestId: number
    errorReason: Protocol.Network.ErrorReason
}

match

இந்த நிகழ்வு புதிய பொருத்தம் சேர்க்கப்படும்போது, continue அல்லது overwrite க்கு முன் வெளியிடப்படுகிறது. பொருத்தம் நிகழ்வு கால்பேக்கில் அனுப்பப்படுகிறது.

பொருத்த இடைமுகம்:

interface MatchEvent {
    url: string // Request URL (without fragment).
    urlFragment?: string // Fragment of the requested URL starting with hash, if present.
    method: string // HTTP request method.
    headers: Record<string, string> // HTTP request headers.
    postData?: string // HTTP POST request data.
    hasPostData?: boolean // True when the request has POST data.
    mixedContentType?: MixedContentType // The mixed content export type of the request.
    initialPriority: ResourcePriority // Priority of the resource request at the time request is sent.
    referrerPolicy: ReferrerPolicy // The referrer policy of the request, as defined in https://www.w3.org/TR/referrer-policy/
    isLinkPreload?: boolean // Whether is loaded via link preload.
    body: string | Buffer | JsonCompatible // Body response of actual resource.
    responseHeaders: Record<string, string> // HTTP response headers.
    statusCode: number // HTTP response status code.
    mockedResponse?: string | Buffer // If mock, emitting the event, also modified it's response.
}

continue

இந்த நிகழ்வு நெட்வொர்க் பதில் மேலெழுதப்படவில்லை அல்லது தடைபடவில்லை, அல்லது பதில் ஏற்கனவே மற்றொரு மாக் மூலம் அனுப்பப்பட்டிருந்தால் வெளியிடப்படுகிறது. requestId நிகழ்வு கால்பேக்கில் அனுப்பப்படுகிறது.

உதாரணங்கள்

நிலுவையிலுள்ள கோரிக்கைகளின் எண்ணிக்கையைப் பெறுதல்:

let pendingRequests = 0
const mock = await browser.mock('**') // it is important to match all requests otherwise, the resulting value can be very confusing.
mock.on('request', ({request}) => {
    pendingRequests++
    console.log(`matched request to ${request.url}, pending ${pendingRequests} requests`)
})
mock.on('match', ({url}) => {
    pendingRequests--
    console.log(`resolved request to ${url}, pending ${pendingRequests} requests`)
})

404 நெட்வொர்க் தோல்வியில் பிழையை எறிதல்:

browser.addCommand('loadPageWithout404', (url, {selector, predicate}) => new Promise(async (resolve, reject) => {
    const mock = await this.mock('**')

    mock.on('match', ({url, statusCode}) => {
        if (statusCode === 404) {
            reject(new Error(`request to ${url} failed with "Not Found"`))
        }
    })

    await this.url(url).catch(reject)

    // waiting here, because some requests can still be pending
    if (selector) {
        await this.$(selector).waitForExist().catch(reject)
    }

    if (predicate) {
        await this.waitUntil(predicate).catch(reject)
    }

    resolve()
}))

await browser.loadPageWithout404(browser, 'some/url', { selector: 'main' })

மாக் பதில் மதிப்பு பயன்படுத்தப்பட்டதா என்பதைத் தீர்மானித்தல்:

const firstMock = await browser.mock('**/foo/**')
const secondMock = await browser.mock('**/foo/bar/**')

firstMock.respondOnce({id: 3, title: 'three'})
secondMock.respond({id: 4, title: 'four'})

firstMock.on('overwrite', () => {
    // triggers for first request to '**/foo/**'
}).on('continue', () => {
    // triggers for rest requests to '**/foo/**'
})

secondMock.on('continue', () => {
    // triggers for first request to '**/foo/bar/**'
}).on('overwrite', () => {
    // triggers for rest requests to '**/foo/bar/**'
})

இந்த உதாரணத்தில், firstMock முதலில் வரையறுக்கப்பட்டது மற்றும் ஒரு respondOnce அழைப்பைக் கொண்டுள்ளது, எனவே முதல் கோரிக்கைக்கு secondMock பதில் மதிப்பு பயன்படுத்தப்படாது, ஆனால் மீதமுள்ள கோரிக்கைகளுக்கு பயன்படுத்தப்படும்.