addInitScript
Adiciona um script que seria avaliado em um dos seguintes cenários:
- Sempre que a página é navegada.
- Sempre que o frame filho é anexado ou navegado. Nesse caso, o script é avaliado no contexto do frame recém-anexado.
O script é avaliado após a criação do documento, mas antes que qualquer um de seus scripts seja executado. Para remover o script de inicialização da página novamente, chame a função que foi retornada por esta função.
Isso é útil para modificar o ambiente JavaScript, por exemplo, para alimentar o Math.random.
Uso
browser.addInitScript(script, args)
Parâmetros
Nome | Tipo | Detalhes |
---|---|---|
script | Function | função a ser injetada como script de inicialização |
args | number, string, boolean | parâmetros para o script |
Exemplos
addInitScript.js
const script = await browser.addInitScript((seed) => {
Math.random = () => seed
}, 42)
await browser.url('https://webdriver.io')
console.log(await browser.execute(() => Math.random())) // returns 42
await reset()
await browser.url('https://webdriver.io')
console.log(await browser.execute(() => Math.random())) // returns a random number
hermore you can also use the `emit` function to send data back to the Node.js environment.
is useful if you want to observe certain events in the browser environment, e.g.:
addInitScriptWithEmit.js
const script = await browser.addInitScript((emit) => {
const observer = new MutationObserver((mutations) => {
for (const mutation of mutations) {
emit(mutation.target.nodeName)
}
})
observer.observe(document, { childList: true, subtree: true })
})
script.on('data', (data) => {
console.log(data) // prints: BODY, DIV, P, ...
})