devtools

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

8.0.14
Source
npm

Version published: 2 years ago

Weekly downloads: 433K; decreased by-22.33%

Maintainers: 3

Weekly downloads

Created: 11 years ago

Source

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
 */
await browser.call(async () => {
    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://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:

Selector Strategies

Browser

Chrome
Firefox (nightly only)
Edge
Safari

Keywords

devtoolsdriver

FAQs

What is devtools?

Is devtools popular?

Is devtools well maintained?

Package last updated on 28 Dec 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install