{
  "doc": {
    "id": "api/cypress-api/browser",
    "title": "Cypress.browser | Cypress Documentation",
    "description": "Cypress.browser returns you properties of the browser.",
    "section": "api",
    "source_path": "/llm/markdown/api/cypress-api/browser.md",
    "version": "e6988a974973e9090ce70406c38cb2b9e0eac9fa",
    "updated_at": "2026-05-15T15:50:22.536Z",
    "headings": [
      {
        "id": "api/cypress-api/browser#cypress-browser",
        "text": "Cypress.browser",
        "level": 1
      },
      {
        "id": "api/cypress-api/browser#syntax",
        "text": "Syntax",
        "level": 2
      },
      {
        "id": "api/cypress-api/browser#examples",
        "text": "Examples",
        "level": 2
      },
      {
        "id": "api/cypress-api/browser#log-browser-information",
        "text": "Log browser information",
        "level": 3
      },
      {
        "id": "api/cypress-api/browser#cypress-browser-returns-browser-object",
        "text": "Cypress.browser returns browser object",
        "level": 4
      },
      {
        "id": "api/cypress-api/browser#conditionals",
        "text": "Conditionals",
        "level": 3
      },
      {
        "id": "api/cypress-api/browser#check-that-chrome-specific-styles-are-applied",
        "text": "Check that Chrome specific styles are applied",
        "level": 4
      },
      {
        "id": "api/cypress-api/browser#screenshot-only-in-headless-browser",
        "text": "Screenshot only in headless browser",
        "level": 4
      },
      {
        "id": "api/cypress-api/browser#history",
        "text": "History",
        "level": 2
      },
      {
        "id": "api/cypress-api/browser#see-also",
        "text": "See also",
        "level": 2
      }
    ]
  },
  "chunks": [
    {
      "id": "api/cypress-api/browser#syntax",
      "doc_id": "api/cypress-api/browser",
      "heading": "Syntax",
      "heading_level": 2,
      "content_markdown": "## Syntax\n\n```\nCypress.browser // returns browser object\n```\n\nThe object has the following properties:\n\n| Property | Type | Description |\n| --- | --- | --- |\n| `channel` | `string` | Release channel of the browser, such as `stable`, `dev`, or `canary`. |\n| `displayName` | `string` | Human-readable display name for the browser. |\n| `family` | `string` | Rendering engine being used. `chromium` or `firefox`. |\n| `isChosen` | `boolean` | Whether the browser is selected in the browser selector of Cypress. |\n| `majorVersion` | `number` | `string` | The major version number of the browser. |\n| `name` | `string` | Machine-friendly name, like `chrome`, `electron`, or `firefox`. |\n| `path` | `string` | Path to the browser on disk. Blank for Electron. |\n| `version` | `string` | Full version. |\n| `isHeadless` | `boolean` | Whether the browser is running headlessly. |\n| `isHeaded` | `boolean` | Whether the browser displays headed. |\n",
      "section": "api",
      "anchors": [
        "syntax"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 216
    },
    {
      "id": "api/cypress-api/browser#examples",
      "doc_id": "api/cypress-api/browser",
      "heading": "Examples",
      "heading_level": 2,
      "content_markdown": "## Examples\n\n### Log browser information\n\n#### `Cypress.browser` returns browser object\n\n```\nit('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  // }})\n```\n\n### Conditionals\n\n#### Check that Chrome specific styles are applied\n\n```\n@media and (-webkit-min-device-pixel-ratio: 0) {  .header {    margin-right: 0;  }}\n```\n\n```\nit('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')  }})\n```\n\n#### Screenshot only in headless browser\n\n```\nCypress.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 browsercy.screenshot()\n```\n",
      "section": "api",
      "anchors": [
        "examples"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 209
    },
    {
      "id": "api/cypress-api/browser#log-browser-information",
      "doc_id": "api/cypress-api/browser",
      "heading": "Log browser information",
      "heading_level": 3,
      "content_markdown": "### Log browser information\n\n#### `Cypress.browser` returns browser object\n\n```\nit('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  // }})\n```\n",
      "section": "api",
      "anchors": [
        "log-browser-information"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 72
    },
    {
      "id": "api/cypress-api/browser#cypress-browser-returns-browser-object",
      "doc_id": "api/cypress-api/browser",
      "heading": "Cypress.browser returns browser object",
      "heading_level": 4,
      "content_markdown": "#### `Cypress.browser` returns browser object\n\n```\nit('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  // }})\n```\n",
      "section": "api",
      "anchors": [
        "cypress-browser-returns-browser-object"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 67
    },
    {
      "id": "api/cypress-api/browser#conditionals",
      "doc_id": "api/cypress-api/browser",
      "heading": "Conditionals",
      "heading_level": 3,
      "content_markdown": "### Conditionals\n\n#### Check that Chrome specific styles are applied\n\n```\n@media and (-webkit-min-device-pixel-ratio: 0) {  .header {    margin-right: 0;  }}\n```\n\n```\nit('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')  }})\n```\n\n#### Screenshot only in headless browser\n\n```\nCypress.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 browsercy.screenshot()\n```\n",
      "section": "api",
      "anchors": [
        "conditionals"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 135
    },
    {
      "id": "api/cypress-api/browser#check-that-chrome-specific-styles-are-applied",
      "doc_id": "api/cypress-api/browser",
      "heading": "Check that Chrome specific styles are applied",
      "heading_level": 4,
      "content_markdown": "#### Check that Chrome specific styles are applied\n\n```\n@media and (-webkit-min-device-pixel-ratio: 0) {  .header {    margin-right: 0;  }}\n```\n\n```\nit('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')  }})\n```\n",
      "section": "api",
      "anchors": [
        "check-that-chrome-specific-styles-are-applied"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 67
    },
    {
      "id": "api/cypress-api/browser#screenshot-only-in-headless-browser",
      "doc_id": "api/cypress-api/browser",
      "heading": "Screenshot only in headless browser",
      "heading_level": 4,
      "content_markdown": "#### Screenshot only in headless browser\n\n```\nCypress.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 browsercy.screenshot()\n```\n",
      "section": "api",
      "anchors": [
        "screenshot-only-in-headless-browser"
      ],
      "path": "/llm/json/chunked/api/cypress-api/browser.json",
      "token_estimate": 65
    }
  ]
}