模拟

模拟请求的响应。您可以根据匹配的 glob 和相应的标头和状态代码定义模拟。调用 mock 方法会返回一个存根对象，您可以使用它来修改 Web 资源的响应。

使用存根对象，您可以返回自定义响应或使请求失败。

有三种方法可以修改响应

• 返回自定义 JSON 对象（用于存根 API 请求）
• 用本地文件替换 Web 资源（服务修改后的 JavaScript 文件）或
• 将资源重定向到不同的 URL

信息

请注意，使用mock命令需要支持 Chrome DevTools 协议。如果您在基于 Chromium 的浏览器中本地运行测试，或者如果您使用 Selenium Grid v4 或更高版本，则会提供此支持。在云端运行自动化测试时，**不能**使用此命令。在自动化协议部分了解更多信息。

用法

browser.mock(url, { method, headers, responseHeaders, postData, statusCode })

参数

名称	类型	详细信息
URL	字符串	要模拟的 URL
filterOptions 可选	MockFilterOptions	通过其他选项过滤模拟资源
filterOptions.method	字符串、函数	按 HTTP 方法过滤资源
filterOptions.headers	对象、函数	按特定请求标头过滤资源
filterOptions.responseHeaders	对象、函数	按特定响应标头过滤资源
filterOptions.postData	字符串、函数	按请求 postData 过滤资源
filterOptions.statusCode	数字、函数	按响应状态码过滤资源

示例

mock.js

it('should mock network resources', async () => {
    // via static string
    const userListMock = await browser.mock('**' + '/users/list')
    // or as regular expression
    const userListMock = await browser.mock(/https:\/\/(domainA|domainB)\.com\/.+/)
    // you can also specifying the mock even more by filtering resources
    // by request or response headers, status code, postData, e.g. mock only responses with specific
    // header set and statusCode
    const strictMock = await browser.mock('**', {
        // mock all json responses
        statusCode: 200,
        headers: { 'Content-Type': 'application/json' },
        responseHeaders: { 'Cache-Control': 'no-cache' },
        postData: 'foobar'
    })

    // comparator function
    const apiV1Mock = await browser.mock('**' + '/api/v1', {
        statusCode: (statusCode) => statusCode >= 200 && statusCode <= 203,
        headers: (headers) => headers['Authorization'] && headers['Authorization'].startsWith('Bearer '),
        responseHeaders: (headers) => headers['Impersonation'],
        postData: (data) => typeof data === 'string' && data.includes('foo')
    })
})

it('should modify API responses', async () => {
    // filter by method
    const todoMock = await browser.mock('**' + '/todos', {
        method: 'get'
    })

    // mock an endpoint with a fixed fixture
    todoMock.respond([{
        title: 'Injected Todo',
        order: null,
        completed: false,
        url: "http://todo-backend-express-knex.herokuapp.com/916"
    }])

    // respond with different status code or header
    todoMock.respond([{
        title: 'Injected Todo',
        order: null,
        completed: false,
        url: "http://todo-backend-express-knex.herokuapp.com/916"
    }], {
        statusCode: 404,
        headers: {
            'x-custom-header': 'foobar'
        }
    })
})

it('should modify text assets', async () => {
    const scriptMock = await browser.mock('**' + '/script.min.js')
    scriptMock.respond('./tests/fixtures/script.js')
})

it('should redirect web resources', async () => {
    const headerMock = await browser.mock('**' + '/header.png')
    headerMock.respond('https://media.giphy.com/media/F9hQLAVhWnL56/giphy.gif')

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