Devtools NPM | npm.io

!WARNING WebdriverIO is deprecating the use of Chrome Devtools as automation protocol through a WebDriver like interface. Instead, you can use the getPuppeteer command to get ahold of a Puppeteer instance for Chrome Devtools introspection and automation.

DevTools

A Chrome DevTools protocol binding that maps WebDriver commands into Chrome DevTools commands using Puppeteer

This package provides a low level interface to run browser automation scripts based on the WebDriver protocol. If you are looking for a tool to automate Chrome or Firefox you should look up Puppeteer. This is suppose to be used by the WebdriverIO package in order to run its automation on the Chrome DevTools protocol.

Install

npm i webdriverio

Example

The following example demonstrates how WebdriverIO can be used with the devtools package as automation binding using the automationProtocol option:

import { remote } from 'webdriverio'

const browser = await remote({
    automationProtocol: 'devtools',
    capabilities: {
        browserName: 'chrome',
        'wdio:devtoolsOptions': {
            headless: true
        }
    }
})

await browser.url('https://webdriver.io')

/**
 * run Puppeteer code
 */
const puppeteer = await browser.getPuppeteer()
const page = (await puppeteer.pages())[0]
await page.setRequestInterception(true)
page.on('request', interceptedRequest => {
    if (interceptedRequest.url().endsWith('webdriverio.png')) {
        return interceptedRequest.continue({
            url: 'https://user-images.githubusercontent.com/10379601/29446482-04f7036a-841f-11e7-9872-91d1fc2ea683.png'
        })
    }

    interceptedRequest.continue()
})

// continue with WebDriver commands
await browser.url('https://v6.webdriver.io')
await browser.pause(2000)

/**
 * now on the https://v6.webdriver.io page you see the Puppeteer logo
 * instead of the WebdriverIO one
 */

await browser.deleteSession()

`wdio:devtoolsOptions` Capability

In order to set Puppeteer specific configurations you can use the wdio:devtoolsOptions capability which is a custom property (compliant to the WebDriver protocol), e.g.:

{
    browserName: 'chrome',
    'wdio:devtoolsOptions': {
        headless: true,
        defaultViewport: {
            width: 800,
            height: 600,
            deviceScaleFactor: 1,
            isMobile: false
        }
    }
}

Commands

The following commands are already supported:

newSession
deleteSession
status
getTimeouts
setTimeouts
getUrl
navigateTo
back
forward
refresh
getTitle
getWindowHandle
closeWindow
switchToWindow
createWindow
getWindowHandles
switchToFrame
switchToParentFrame
getWindowRect
setWindowRect
maximizeWindow (not possible with Puppeteer)
minimizeWindow (not possible with Puppeteer)
fullscreenWindow (not possible with Puppeteer)
findElement
findElements
findElementFromElement
findElementsFromElement
getActiveElement
isElementSelected
isElementDisplayed
getElementAttribute
getElementProperty
getElementCSSValue
getElementText
getElementTagName
getElementRect
isElementEnabled
elementClick
elementClear
elementSendKeys
getPageSource
executeScript
executeAsyncScript
getAllCookies
getNamedCookie
addCookie
deleteAllCookies
deleteCookie
performActions
releaseActions
dismissAlert
acceptAlert
getAlertText
sendAlertText
takeScreenshot
takeElementScreenshot

Selector Strategies

Browser

Chrome
Firefox (nightly only)
Edge
Safari

devtoolsdriver

@types/node @wdio/config @wdio/logger @wdio/protocols @wdio/types @wdio/utils chrome-launcher edge-paths import-meta-resolve puppeteer-core query-selector-shadow-dom ua-parser-js uuid which

@everything-registry/sub-chunk-1474 hermione aladinet bookstroy bv_automation_eternal_modules testplane tinymce-plugin-toy codeceptjs wdio-cucumber wdio-ui5-service @eui/automation @infinitebrahmanuniverse/nolb-devt

12 days ago

19 days ago

1 month ago

1 month ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

6 months ago

6 months ago

7 months ago

10 months ago

5 months ago

9 months ago

6 months ago

6 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

8 months ago

5 months ago

5 months ago

5 months ago

5 months ago

9 months ago

9 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

8 months ago

8 months ago

7 months ago

9 months ago

7 months ago

7 months ago

7 months ago

7 months ago

9 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

7 months ago

6 months ago

6 months ago

6 months ago

6 months ago

7 months ago

6 months ago

7 months ago

10 months ago

10 months ago

11 months ago

12 months ago

11 months ago

12 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

12 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

10 years ago

DevTools

Install

Example

wdio:devtoolsOptions Capability

Commands

Selector Strategies

Browser

`wdio:devtoolsOptions` Capability