Multiremote

O WebdriverIO permite que você execute múltiplas sessões automatizadas em um único teste. Isso se torna útil quando você está testando recursos que exigem múltiplos usuários (por exemplo, aplicativos de chat ou WebRTC).

Em vez de criar várias instâncias remotas onde você precisa executar comandos comuns como newSession ou url em cada instância, você pode simplesmente criar uma instância multiremote e controlar todos os navegadores ao mesmo tempo.

Para fazer isso, basta usar a função multiremote() e passar um objeto com nomes associados a capabilities como valores. Ao dar um nome a cada capacidade, você pode facilmente selecionar e acessar essa única instância ao executar comandos em uma instância específica.

informação

Multiremote não foi feito para executar todos os seus testes em paralelo. Ele é destinado a ajudar a coordenar múltiplos navegadores e/ou dispositivos móveis para testes de integração especiais (por exemplo, aplicativos de chat).

Todas as instâncias multiremote retornam uma matriz de resultados. O primeiro resultado representa a capacidade definida primeiro no objeto de capacidade, o segundo resultado a segunda capacidade e assim por diante.

Usando o Modo Standalone

Aqui está um exemplo de como criar uma instância multiremote no modo standalone:

import { multiremote } from 'webdriverio'

(async () => {
    const browser = await multiremote({
        myChromeBrowser: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    })

    // open url with both browser at the same time
    await browser.url('http://json.org')

    // call commands at the same time
    const title = await browser.getTitle()
    expect(title).toEqual(['JSON', 'JSON'])

    // click on an element at the same time
    const elem = await browser.$('#someElem')
    await elem.click()

    // only click with one browser (Firefox)
    await elem.getInstance('myFirefoxBrowser').click()
})()

Usando o WDIO Testrunner

Para usar o multiremote no testrunner WDIO, basta definir o objeto capabilities no seu wdio.conf.js como um objeto com os nomes dos navegadores como chaves (em vez de uma lista de capacidades):

export const config = {
    // ...
    capabilities: {
        myChromeBrowser: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    }
    // ...
}

Isso criará duas sessões WebDriver com Chrome e Firefox. Em vez de apenas Chrome e Firefox, você também pode iniciar dois dispositivos móveis usando Appium ou um dispositivo móvel e um navegador.

Você também pode executar multiremote em paralelo colocando o objeto de capacidades do navegador em um array. Certifique-se de incluir o campo capabilities em cada navegador, pois é assim que diferenciamos cada modo.

export const config = {
    // ...
    capabilities: [{
        myChromeBrowser0: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser0: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    }, {
        myChromeBrowser1: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myFirefoxBrowser1: {
            capabilities: {
                browserName: 'firefox'
            }
        }
    }]
    // ...
}

Você pode até mesmo iniciar um dos serviços em nuvem juntamente com instâncias locais de Webdriver/Appium, ou Selenium Standalone. O WebdriverIO detecta automaticamente as capacidades de backend em nuvem se você especificar qualquer um dos bstack:options (Browserstack), sauce:options (SauceLabs), ou tb:options (TestingBot) nas capacidades do navegador.

export const config = {
    // ...
    user: process.env.BROWSERSTACK_USERNAME,
    key: process.env.BROWSERSTACK_ACCESS_KEY,
    capabilities: {
        myChromeBrowser: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        myBrowserStackFirefoxBrowser: {
            capabilities: {
                browserName: 'firefox',
                'bstack:options': {
                    // ...
                }
            }
        }
    },
    services: [
        ['browserstack', 'selenium-standalone']
    ],
    // ...
}

Qualquer tipo de combinação de OS/navegador é possível aqui (incluindo navegadores móveis e desktop). Todos os comandos que seus testes chamam através da variável browser são executados em paralelo com cada instância. Isso ajuda a simplificar seus testes de integração e acelerar sua execução.

Por exemplo, se você abrir uma URL:

browser.url('https://socketio-chat-h9jt.herokuapp.com/')

O resultado de cada comando será um objeto com os nomes dos navegadores como chave e o resultado do comando como valor, assim:

// wdio testrunner example
await browser.url('https://www.whatismybrowser.com')

const elem = await $('.string-major')
const result = await elem.getText()

console.log(result[0]) // returns: 'Chrome 40 on Mac OS X (Yosemite)'
console.log(result[1]) // returns: 'Firefox 35 on Mac OS X (Yosemite)'

Observe que cada comando é executado um por um. Isso significa que o comando termina quando todos os navegadores o executaram. Isso é útil porque mantém as ações do navegador sincronizadas, o que facilita a compreensão do que está acontecendo no momento.

Às vezes, é necessário fazer coisas diferentes em cada navegador para testar algo. Por exemplo, se quisermos testar um aplicativo de chat, deve haver um navegador que envia uma mensagem de texto enquanto outro navegador espera para recebê-la e, em seguida, executa uma verificação sobre ela.

Ao usar o testrunner WDIO, ele registra os nomes dos navegadores com suas instâncias no escopo global:

const myChromeBrowser = browser.getInstance('myChromeBrowser')
await myChromeBrowser.$('#message').setValue('Hi, I am Chrome')
await myChromeBrowser.$('#send').click()

// wait until messages arrive
await $('.messages').waitForExist()
// check if one of the messages contain the Chrome message
assert.true(
    (
        await $$('.messages').map((m) => m.getText())
    ).includes('Hi, I am Chrome')
)

Neste exemplo, a instância myFirefoxBrowser começará a esperar por uma mensagem assim que a instância myChromeBrowser tiver clicado no botão #send.

O Multiremote torna fácil e conveniente controlar vários navegadores, seja você querer que eles façam a mesma coisa em paralelo ou coisas diferentes em conjunto.

Acessando instâncias do navegador usando strings através do objeto browser

Além de acessar a instância do navegador através de suas variáveis globais (por exemplo, myChromeBrowser, myFirefoxBrowser), você também pode acessá-las através do objeto browser, por exemplo, browser["myChromeBrowser"] ou browser["myFirefoxBrowser"]. Você pode obter uma lista de todas as suas instâncias através de browser.instances. Isso é especialmente útil ao escrever etapas de teste reutilizáveis que podem ser executadas em qualquer navegador, por exemplo:

wdio.conf.js:

    capabilities: {
        userA: {
            capabilities: {
                browserName: 'chrome'
            }
        },
        userB: {
            capabilities: {
                browserName: 'chrome'
            }
        }
    }

Arquivo Cucumber:

When User A types a message into the chat

Arquivo de definição de etapa:

When(/^User (.) types a message into the chat/, async (userId) => {
    await browser.getInstance(`user${userId}`).$('#message').setValue('Hi, I am Chrome')
    await browser.getInstance(`user${userId}`).$('#send').click()
})

Estendendo os Tipos TypeScript

Se você está usando TypeScript e gostaria de acessar a instância do driver diretamente do objeto multiremote, você também pode estender os tipos multiremote para isso. Por exemplo, dadas as seguintes capacidades:

export const config: WebdriverIO.MultiremoteConfig = {
    // ...
    capabilities: {
        myAppiumDriver: {
            // ...
        },
        myChromeDriver: {
            // ...
        }
    }
    // ...
}

Você pode estender a instância multiremote adicionando seus nomes de driver personalizados, por exemplo:

declare namespace WebdriverIO {
    interface MultiRemoteBrowser {
        myAppiumDriver: WebdriverIO.Browser
        myChromeDriver: WebdriverIO.Browser
    }
}

Agora você pode acessar os drivers diretamente através de, por exemplo:

multiremotebrowser.myAppiumDriver.$$(...)
multiremotebrowser.myChromeDriver.$(...)