Pular para o conteúdo principal

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
NomeTipoDetalhes
scriptFunctionfunção a ser injetada como script de inicialização
argsnumber, string, booleanparâ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, ...
})

Welcome! How can I help?

WebdriverIO AI Copilot