Cypress.browser

Cypress.browser returns you properties of the browser.

Syntax

Cypress.browser // returns browser object

The object has the following properties:

Property Type Description
channel string Release channel of the browser, such as stable, dev, or canary.
displayName string Human-readable display name for the browser.
family string Rendering engine being used. chromium or firefox.
isChosen boolean Whether the browser is selected in the browser selector of the Test Runner.
majorVersion number The major version number of the browser.
name string Machine-friendly name, like chrome, electron, or firefox.
path string Path to the browser on disk. Blank for Electron.
version string Full version.
isHeadless boolean Whether the browser is running headlessly.
isHeaded boolean Whether the browser displays headed.

Examples

Log browser information

Cypress.browser returns browser object

it('log browser info', () => {
  console.log(Cypress.browser)
  // {
  //   channel: 'stable',
  //   displayName: 'Chrome',
  //   family: 'chromium',
  //   isChosen: true,
  //   majorVersion: 80,
  //   name: 'chrome',
  //   path: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
  //   version: '80.0.3987.87',
  //   isHeaded: true,
  //   isHeadless: false
  // }
})

Conditionals

Check that Chrome specific styles are applied

@media and (-webkit-min-device-pixel-ratio: 0) {
  .header {
    margin-right: 0;
  }
}
it('has correct Chrome specific css property', () => {
  // if in Chrome, check css property was properly applied
  if (Cypress.browser.name === 'chrome') {
    cy.get('.header').should('have.css', 'margin-right').and('eq', '0')
  }
})

Screenshot only in headless browser

Cypress.Commands.overwrite(
  'screenshot',
  (originalFn, subject, name, options) => {
    // only take screenshots in headless browser
    if (Cypress.browser.isHeadless) {
      // return the original screenshot function
      return originalFn(subject, name, options)
    }

    return cy.log('No screenshot taken when headed')
  }
)

// only takes in headless browser
cy.screenshot()

History

Version Changes
3.0.2 Cypress.browser introduced

See also

© 2017 Cypress.io
Licensed under the MIT License.
https://docs.cypress.io/api/cypress-api/browser