addInitScript

Fügt ein Skript hinzu, das in einem der folgenden Szenarien ausgeführt wird:

• Wann immer die Seite navigiert wird.
• Wann immer ein Unterframe angehängt oder navigiert wird. In diesem Fall wird das Skript im Kontext des neu angehängten Frames ausgewertet.

Das Skript wird ausgewertet, nachdem das Dokument erstellt wurde, aber bevor eines seiner Skripte ausgeführt wurde. Um das Initialisierungsskript wieder von der Seite zu entfernen, rufen Sie die Funktion auf, die von dieser Funktion zurückgegeben wurde.

Dies ist nützlich, um die JavaScript-Umgebung zu erweitern, z.B. um Math.random zu initialisieren.

Verwendung

browser.addInitScript(script, args)

Parameter

Name	Type	Details
script	Function	Funktion, die als Initialisierungsskript injiziert werden soll
args	number, string, boolean	Parameter für das Skript

Beispiele

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, ...
})