---
id: api/cypress-api/platform
title: Cypress.platform
description: Get the underlying OS name as returned from Node's os.platform() in Cypress.
section: api
source_path: docs/api/cypress-api/platform.mdx
version: fbc9225067c51c52ee13224e3b702cf8a025ec12
updated_at: '2026-08-14T12:36:26.878Z'
---
# Cypress.platform

`Cypress.platform` returns the underlying OS name, as returned from Node's [`os.platform()`](https://nodejs.org/api/os.html#os_os_platform).

Even though Cypress runs in the browser, it automatically makes this property available for use in your tests.

## Syntax

```
Cypress.platform // 'darwin'
```

## Examples

### Conditionals

```
it('has JSON files', () => {  // if windows do one thing, else do another  const cmd = Cypress.platform === 'win32' ? 'dir *.json' : 'ls *.json'  cy.exec(cmd).its('stdout').should('include', 'package.json')})
```